[Bug]: GenerateMetadataJob hang if folder/file missing but still in filecache

⚠️ This issue respects the following points: ⚠️

• This is a bug, not a question or a configuration/webserver/proxy issue.
• This issue is not already reported on Github OR Nextcloud Community Forum (I've searched it).
• Nextcloud Server is up to date. See Maintenance and Release Schedule for supported versions.
• I agree to follow Nextcloud's Code of Conduct.

Bug description

GenerateMetadataJob hang if folder/file already missing but still in filecache

Steps to reproduce

1. create a new user
2. login, let nextcloud create the user home folder, then logout
3. remove the home folder from filesystem
4. run 'occ maintenance:repair' to create GenerateMetadataJob
5. run 'occ background-job:execute --force-execute xxxx' for GenerateMetadataJob's job id
6. the above command will hang when processing the new user's file => 'Business model canvas.odg'

Expected behavior

bypass all missing folders/files, don't hang the job.

Installation method

Community Manual installation with Archive

Nextcloud Server version

29

Operating system

Debian/Ubuntu

PHP engine version

PHP 8.3

Web server

Nginx

Database engine version

MariaDB

Is this bug present after an update or on a fresh install?

None

Are you using the Nextcloud Server Encryption module?

None

What user-backends are you using?

• Default user-backend (database)
• LDAP/ Active Directory
• SSO - SAML
• Other

Configuration report

No response

List of activated Apps

No response

Nextcloud Signing status

No response

Nextcloud Logs

No response

Additional info

IMAP user-backend

Start by reproducing the hang with occ maintenance:repair and occ background-job:execute --force-execute using the reported missing home folder and filecache state. Trace GenerateMetadataJob while it processes the missing file or folder; done means the job bypasses missing filesystem entries and completes instead of hanging.