Fallnotiz: Nextcloud „File is locked“ (423 Locked) beheben

Das Signal richtig lesen

Der Wortlaut der Meldung und der Zeitpunkt im Log sind der Ausgangspunkt. Erst danach lohnt sich die Suche nach der Ursache.

OCP\Lock\LockedException: "files/9a3c1e7d/Dokumente/Bericht.docx" is locked, existing lock on file: exclusive

Mögliche Ursachen eingrenzen

• File Locking läuft über die Datenbank statt über Redis; Sperren bleiben nach Abbrüchen hängen.
• Abgebrochener Upload oder Sync des Desktop-Clients, PHP-Prozess wurde per Timeout beendet.
• Die Datei ist in Collabora oder OnlyOffice noch geöffnet.
• Hintergrundjobs laufen nicht (kein System-Cron), abgelaufene Sperren werden nicht aufgeräumt.

Prüfen, bevor du etwas änderst

1. Welches Locking-Backend ist konfiguriert?

   sudo -u www-data php /var/www/nextcloud/occ config:system:get memcache.locking

2. Erreichbarkeit von Redis prüfen

   redis-cli ping

3. Anzahl der Sperren in der Datenbank (bei DB-Locking)

   mysql -u nextcloud -p nextcloud -e 'SELECT COUNT(*) FROM oc_file_locks WHERE `lock` <> 0;'

4. Modus der Hintergrundjobs prüfen

   sudo -u www-data php /var/www/nextcloud/occ config:app:get core backgroundjobs_mode

Beheben und erneut testen

1. Redis als Locking-Backend einrichten: 'memcache.locking' => '\OC\Memcache\Redis' in config.php.
2. Hintergrundjobs auf System-Cron umstellen: */5 * * * * php -f /var/www/nextcloud/cron.php im Crontab von www-data.
3. Verwaiste DB-Sperren entfernen: Wartungsmodus an, DELETE FROM oc_file_locks WHERE 1;, Wartungsmodus aus.
4. Bei Redis laufen Sperren per TTL ab; nur im Notfall die Redis-Datenbank leeren, und nur wenn sie ausschließlich von Nextcloud genutzt wird.

Danach denselben Vorgang erneut ausführen und das Ergebnis mit der ursprünglichen Fehlermeldung vergleichen.

Für das nächste Ticket festhalten

Notiere die genaue Fehlermeldung, das Ergebnis der Prüfung, die Änderung und den erneuten Test. So kann das Team den nächsten Fall schneller zuordnen.

Kann ich File Locking einfach abschalten?

Technisch ja (filelocking.enabled auf false), aber dann riskieren Sie beschädigte Dateien bei gleichzeitigen Zugriffen. Besser Redis nutzen.

Ausführliche Fehlerseite: Nextcloud: „File is locked“ und HTTP 423 Locked