Un fichier Nextcloud refuse de se synchroniser parce qu'il est verrouillé, ou deux collaborateurs retrouvent des versions concurrentes du même document. En 2026, ces situations demandent d'abord un bon diagnostic : le verrouillage transactionnel du serveur et le conflit créé par le client de synchronisation ne répondent pas au même problème.
Le premier protège l'intégrité des fichiers pendant leur enregistrement. Le second conserve deux modifications que le client ne peut pas fusionner seul. Ce guide explique comment les distinguer, pourquoi Redis améliore la gestion des verrous et quelles actions effectuer sans supprimer aveuglément des données techniques.
À quoi sert le verrouillage transactionnel de Nextcloud ?
Le verrouillage transactionnel de fichiers empêche deux écritures simultanées de modifier la même ressource au même moment. Selon la documentation d'administration Nextcloud, ce mécanisme agit au-dessus du système de fichiers. Il n'impose donc pas un format de stockage particulier pour gérer ses verrous.
Lorsqu'une opération touche un fichier, Nextcloud peut aussi verrouiller son dossier parent. Le dossier ne peut pas être renommé pendant l'activité en cours. Le mécanisme sait également gérer les fichiers partagés, les stockages externes et les fichiers chiffrés. Un transfert interrompu doit normalement libérer son verrou après l'arrêt de la transaction.
Cette protection ne réserve pas le document à un seul collaborateur pendant toute sa session de travail. Deux personnes peuvent ouvrir et modifier le même fichier. Le verrou transactionnel intervient surtout au moment de l'enregistrement pour éviter deux sauvegardes concurrentes susceptibles de corrompre la donnée.
| Situation | Ce que fait Nextcloud | Réponse adaptée |
|---|---|---|
| Deux écritures arrivent au même instant | Le verrou transactionnel ordonne les enregistrements | Vérifier le service de verrouillage si l'erreur persiste |
| Le fichier local et le fichier distant ont changé entre deux synchronisations | Le client crée une copie en conflit | Comparer les deux versions puis fusionner les changements |
| Plusieurs personnes éditent un document bureautique | Le verrou transactionnel ne signale pas qui travaille dessus | Employer un éditeur collaboratif ou une règle d'équipe |
| Une opération est encore active | Le fichier reste temporairement indisponible pour une écriture concurrente | Laisser l'opération se terminer avant de réessayer |
Un verrou n'est pas un droit d'accès
Le verrouillage transactionnel protège une opération technique. Les partages, groupes et permissions déterminent qui peut consulter ou modifier le fichier. Pour revoir l'ensemble de l'architecture, commencez par le guide Nextcloud.
Verrouillage ou conflit de synchronisation : comment les distinguer ?
Le client de bureau Nextcloud téléverse les changements locaux et récupère les changements distants. Si le même fichier a changé des deux côtés entre deux passages de synchronisation, il ne choisit pas automatiquement une version. Il télécharge la version distante sous le nom d'origine et conserve le travail local dans un fichier dont le nom contient généralement conflicted copy.
Cette copie est une protection, pas un doublon à supprimer immédiatement. Il faut ouvrir les deux documents, comparer leur contenu, reporter les modifications utiles dans le fichier principal puis supprimer la copie conflictuelle seulement après validation. Par défaut, la documentation du client indique que cette copie locale n'est pas envoyée au serveur.
Une erreur de verrouillage se présente autrement. L'enregistrement ou le transfert est refusé tant que Nextcloud considère qu'une transaction concurrente possède le verrou. Le problème peut viser un seul fichier, un dossier parent ou plusieurs opérations lorsque le service utilisé pour stocker les verrous ne répond plus correctement.
La distinction change toute la procédure :
- Copie conflictuelle présente : comparez les contenus et choisissez les changements à conserver.
- Message indiquant que le fichier est verrouillé : recherchez l'opération active et contrôlez le mécanisme serveur.
- Erreur sur un fichier partagé ou externe : identifiez aussi le propriétaire, le partage et le stockage concerné.
- Échec généralisé : vérifiez le service de cache, la base de données et les journaux avant de toucher aux fichiers.
Le guide de synchronisation Nextcloud détaille le fonctionnement des clients, tandis que ce guide se concentre sur la protection des écritures et les incidents de verrouillage.
Pourquoi Redis est-il recommandé pour les verrous ?
Nextcloud utilise la base de données comme backend de verrouillage par défaut. La documentation officielle précise que ce choix peut ajouter une charge importante à la base. La directive memcache.locking permet de confier les verrous à un cache adapté et d'alléger ce travail.
Redis est le choix documenté et testé pour le verrouillage transactionnel. APCu reste pertinent comme cache local, mais ne remplace pas un backend de verrouillage partagé. Le guide actuel du cache indique que Valkey et KeyDB devraient fonctionner comme backends compatibles Redis, tout en précisant que les tests automatisés officiels portent sur Redis Open Source.
Une configuration simple sur un serveur unique peut prendre cette forme, à adapter aux chemins, secrets et méthodes d'installation de votre environnement :
'memcache.local' => '\\OC\\Memcache\\APCu',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' => [
'host' => '/run/redis/redis-server.sock',
'port' => 0,
'timeout' => 0.0,
],
La documentation recommande une socket Unix lorsque Redis et Nextcloud fonctionnent sur le même système. Pour une installation répartie sur plusieurs serveurs web, tous les nœuds doivent pointer vers le même service ou cluster de verrouillage. Une valeur localhost différente sur chaque nœud créerait plusieurs espaces de verrous indépendants.
Ne copiez pas une configuration Redis sans vérifier l'architecture
Le socket, le port, l'authentification et le partage du backend dépendent du déploiement. Une erreur peut interrompre les opérations de fichiers. Sauvegardez la configuration et prévoyez un retour arrière avant toute modification.
Comment diagnostiquer un fichier bloqué sans aggraver l'incident ?
Commencez par limiter le périmètre. Notez le chemin exact, le compte concerné, le client utilisé, l'heure de l'erreur et l'action effectuée : envoi, renommage, déplacement, suppression ou synchronisation. Vérifiez ensuite si l'incident touche un seul utilisateur, tous les membres d'un partage ou l'ensemble de l'instance.
Reproduisez prudemment avec une action non destructive. Par exemple, tentez de lire le fichier puis d'envoyer une petite copie portant un autre nom dans le même dossier. Cette comparaison aide à séparer un verrou attaché à une ressource précise d'un problème plus large de stockage ou de backend.
Contrôlez ensuite les éléments suivants :
- Activité en cours : un client, une application mobile ou une intégration WebDAV transfère-t-il encore le fichier ?
- Dossier parent : un déplacement ou un renommage du dossier est-il en cours ?
- Partage : plusieurs comptes modifient-ils la même ressource au même moment ?
- Stockage externe : le montage reste-t-il accessible depuis Nextcloud ?
- Redis : le service répond-il et la configuration
memcache.lockingcible-t-elle le bon backend ? - Architecture à plusieurs nœuds : tous les serveurs web utilisent-ils le même service de verrouillage ?
- Journaux : l'erreur serveur apparaît-elle à l'heure exacte de l'incident avec un identifiant de requête exploitable ?
Augmentez temporairement le niveau de détail uniquement si le niveau courant ne suffit pas. La documentation de la commande occ prévoit les options -v, -vv et -vvv pour les commandes administratives. Évitez toutefois de laisser un niveau très bavard en permanence, car les journaux peuvent croître rapidement et contenir des informations opérationnelles sensibles.
Le guide Activity et audit Nextcloud aide à distinguer les événements visibles par les utilisateurs des journaux techniques destinés à l'administrateur. Conservez l'heure, le chemin et l'identifiant de requête dans votre ticket : ce trio réduit fortement les recherches inutiles.
Quelle procédure suivre pour libérer la situation en sécurité ?
La première action est souvent d'arrêter les tentatives concurrentes. Mettez en pause les clients qui travaillent sur le fichier, fermez l'éditeur concerné et vérifiez qu'aucun téléversement n'est encore actif. Attendez ensuite la fin normale de la transaction avant de relancer une seule opération de test.
Si l'erreur concerne plusieurs fichiers, contrôlez Redis ou le backend de base de données avant toute manipulation des tables. Corrigez d'abord une panne de service, une cible erronée ou une divergence de configuration entre nœuds. Redémarrer au hasard plusieurs composants complique la chronologie et peut masquer la cause sans la supprimer.
La documentation officielle du verrouillage décrit une libération automatique des verrous après une transaction interrompue et explique la configuration Redis. Elle ne présente pas une commande universelle à lancer pour effacer manuellement tous les verrous. Méfiez-vous donc des procédures anciennes qui recommandent de vider directement une table de base de données ou l'ensemble d'un cache.
Une suppression globale peut toucher des opérations encore légitimes. Elle peut aussi transformer un incident limité en écritures concurrentes. Si une intervention de bas niveau devient nécessaire, elle doit suivre une sauvegarde vérifiée, une interruption maîtrisée des écritures et une procédure compatible avec la version réellement installée.
Après correction :
- testez la lecture puis l'écriture sur une copie sans valeur métier ;
- relancez un seul client de synchronisation ;
- contrôlez les journaux pendant le transfert ;
- rouvrez progressivement les autres clients ;
- vérifiez les versions du fichier et l'absence de copie conflictuelle oubliée ;
- documentez la cause et le changement effectué.
La sauvegarde Nextcloud reste indispensable avant les opérations sensibles. Les versions et la corbeille facilitent certains retours en arrière, mais elles ne remplacent pas une sauvegarde séparée et restaurable.
Comment réduire les conflits au quotidien ?
Le bon backend de verrouillage protège les enregistrements, mais il ne coordonne pas le travail humain. Pour les documents bureautiques modifiés à plusieurs, utilisez un éditeur collaboratif pris en charge par l'organisation plutôt que des copies locales ouvertes simultanément. Chaque équipe doit aussi savoir reconnaître une copie conflictuelle et la conserver jusqu'à la fusion du contenu.
Évitez de déplacer de grandes arborescences pendant que des clients les synchronisent. Planifiez les migrations, changements de propriétaire et opérations sur les stockages externes. Lorsque plusieurs intégrations automatisées travaillent dans le même dossier, attribuez des périmètres clairs et journalisez leurs actions.
Une politique simple réduit les incidents :
- un propriétaire métier par espace partagé ;
- des règles de nommage compréhensibles ;
- un canal défini pour signaler un conflit ;
- une vérification des clients obsolètes ;
- un suivi de Redis, de la base et du stockage ;
- un test de restauration périodique ;
- une procédure écrite avant toute maintenance.
Le verrouillage transactionnel ne remplace pas les permissions, les partages ni la protection des comptes. Pour traiter ces autres couches, consultez le guide de sécurité Nextcloud. L'objectif est de combiner contrôle d'accès, intégrité des écritures, traçabilité et récupération.
Conclusion : sécuriser les écritures avant de chercher à forcer le déblocage
Le verrouillage de fichiers Nextcloud protège les enregistrements concurrents, tandis qu'une copie conflictuelle conserve deux modifications impossibles à fusionner automatiquement. Le bon réflexe consiste à identifier le mécanisme concerné, arrêter les écritures concurrentes, vérifier Redis ou la base, puis tester sur une copie.
Une suppression globale des verrous sans diagnostic peut aggraver l'incident. Privilégiez une architecture cohérente, des journaux exploitables, une sauvegarde restaurable et une procédure adaptée à la version installée.
Découvrir l'offre Nextcloud GaprodCloud collaboratif Nextcloud hébergé en France