Accueil
» ADMINISTRATEUR RÉSEAU
»
Résolution de l'erreur « CSync Unknown Error » du client ownCloud Desktop lors de la synchronisation
Résolution de l'erreur « CSync Unknown Error » du client ownCloud Desktop lors de la synchronisation
Exemple illustratif : Jordan synchronise un dossier de projet local avec l’application de bureau ownCloud sous Windows. Le compte fonctionnait normalement, mais le client signale soudainement une erreur CSync inconnue et interrompt la synchronisation. Les fichiers sont toujours présents localement et visibles dans l’interface web d’ownCloud. Cet exemple est hypothétique ; il sert uniquement à illustrer la procédure de dépannage documentée.
La bonne nouvelle est qu'ownCloud propose une solution rapide pour résoudre ce problème : quittez l'application de bureau, supprimez le ._sync_xxxxxxx.dbfichier caché du dossier de synchronisation concerné, puis redémarrez l'application. Cette base de données correspond au journal de synchronisation local. Sa reconstruction peut corriger un état de synchronisation endommagé ou incohérent, mais ownCloud prévient que sa suppression efface également certains paramètres qui contrôlent les fichiers téléchargés.
En octobre 2026, la documentation de l'application ownCloud Desktop App 7.1 mentionne toujours cette procédure pour l'erreur inconnue CSync . Notez également la séparation actuelle des produits : l'application Desktop App 7.x prend uniquement en charge ownCloud Infinite Scale ; les administrateurs utilisant ownCloud Classic Server 10 ou 11 doivent rester sur la série Desktop App 6. Consultez les notes de version officielles de l'application ownCloud Desktop App avant de procéder à une mise à jour majeure.
Que signifie généralement « Erreur inconnue CSync » ?
Le message est volontairement général. Il n'identifie aucune panne côté serveur, aucun nom de fichier incorrect ni aucun problème d'autorisations. La documentation de dépannage actuelle de l'application de bureau ownCloud traite ce problème en premier lieu comme un problème de synchronisation et recommande de reconstruire la base de données de synchronisation locale avant de procéder à un diagnostic plus approfondi.
L'ordre des opérations est important. Dans le cas hypothétique de Jordan, la première étape la plus sûre consiste à ne pas supprimer le dossier local du projet, à ne pas supprimer le compte ni à purger les données du serveur. La réparation documentée ne concerne que la base de données de synchronisation cachée utilisée par cette connexion.
Étape 1 à titre d'illustration : vérifiez que le message est bien « Erreur inconnue CSync » avant d'appliquer la réparation de la base de données de synchronisation.
Fermez l'application ownCloud Desktop avant d'accéder à sa base de données de synchronisation. Ne vous contentez pas de réduire la fenêtre. Utilisez la fonction « Quitter » ou « Fermer » de l'application afin que le client cesse d'écrire dans le journal.
Dans cet exemple, Jordan attend d'abord que toute activité visible cesse, quitte ownCloud et vérifie que l'application n'est plus en cours d'exécution. Cela réduit le risque de supprimer un fichier de base de données pendant que le client l'a encore ouvert.
Étape 2 : Afficher les fichiers cachés dans le dossier de synchronisation concerné
Le fichier que ownCloud vous demande de supprimer est caché. Ouvrez le répertoire racine du dossier de synchronisation ownCloud concerné et activez l'affichage des éléments cachés dans votre gestionnaire de fichiers. Sous Windows, l'Explorateur de fichiers permet d'afficher les éléments cachés via ses options d'affichage. Sous macOS ou Linux, utilisez la méthode d'affichage habituelle de votre gestionnaire de fichiers.
Recherchez un nom de fichier correspondant au modèle :
._sync_xxxxxxx.db
Les caractères exacts qui suivent ._sync_peuvent varier. Ne supprimez pas les documents ou dossiers ordinaires simplement parce qu'ils portent un nom similaire.
Étape 2 à titre illustratif : activer les fichiers cachés et identifier le ._sync_….dbjournal caché dans la racine de synchronisation concernée.
Étape 3 : Supprimez uniquement la base de données de synchronisation cachée
Une fois ownCloud complètement arrêté, supprimez le ._sync_xxxxxxx.dbfichier correspondant. La page de dépannage officielle recommande expressément de supprimer ce fichier, puis de redémarrer l'application de bureau.
Dans l'exemple de Jordan, seul ce fichier est supprimé. Les données locales du projet restent intactes. Cette distinction est importante car la suppression de l'intégralité du dossier de synchronisation local peut engendrer un problème de récupération inutile, tandis que la suppression du fichier journal permet à ownCloud de reconstruire son état de synchronisation local.
Avant de continuer : ownCloud vous avertit que cette opération peut effacer certains paramètres qui déterminent les fichiers téléchargés. Si vous utilisez la synchronisation sélective ou si vous avez volontairement exclu des dossiers volumineux, notez ces choix afin de pouvoir les consulter après le redémarrage.
Étape 3 à titre d'illustration : supprimez uniquement la base de données de synchronisation cachée lorsque l'application de bureau ownCloud n'est pas en cours d'exécution.
Étape 4 : Redémarrez ownCloud et laissez-le reconstruire l’état de synchronisation.
Relancez l'application de bureau. Elle devrait recréer la base de données de synchronisation locale et analyser à nouveau la relation entre le dossier local et le serveur. Laissez au client le temps de terminer la recherche avant de conclure à un échec de la réparation, surtout si l'arborescence de synchronisation contient de nombreux fichiers.
Le critère de réussite hypothétique de Jordan est simple : l’erreur CSync ne se reproduit pas immédiatement, le client lance une analyse ou une synchronisation, et le compte finit par être à jour. Si les options de synchronisation sélective ont été modifiées, Jordan les vérifie avant d’autoriser les téléchargements volumineux.
Étape 4 à titre d'illustration : redémarrez le client, laissez le journal de synchronisation se reconstruire et vérifiez que la synchronisation peut à nouveau se poursuivre.
Si l'erreur se reproduit, vérifiez les conditions de synchronisation sous-jacentes.
La suppression de la base de données de synchronisation est la solution documentée pour cette erreur CSync spécifique, mais elle ne résout pas tous les problèmes pouvant entraîner un échec de synchronisation. Si le message réapparaît, utilisez l'état reconstruit comme point de départ et vérifiez les éléments suivants un par un.
1. Vérifiez que le compte et la connexion au serveur fonctionnent toujours.
Connectez-vous à l'interface web d'ownCloud dans un navigateur. ownCloud recommande cette méthode comme premier test de connectivité. Si l'interface web est inaccessible, si vos identifiants sont incorrects ou si tous les clients de bureau échouent alors que le site web fonctionne, demandez à l'administrateur de vérifier l'instance, l'URL de connexion et les paramètres du proxy.
2. Vérifiez l'espace disque disponible
Le guide de dépannage d'ownCloud 7.1 indique qu'un téléchargement est ignoré ou interrompu s'il réduit l'espace disque disponible en dessous de 250 Mo, et que la synchronisation s'arrête complètement si l'espace libre restant descend en dessous de 50 Mo. Assurez-vous de disposer d'un espace libre largement supérieur à ces seuils avant de réessayer.
3. Vérifiez les autorisations des dossiers Windows lorsque VFS est impliqué.
Sous Windows avec fichiers virtuels, une erreur d'accès refusé aux métadonnées peut survenir si l'utilisateur propriétaire ne dispose plus des autorisations requises sur le dossier synchronisé. La documentation ownCloud indique que l'utilisateur propriétaire doit disposer du contrôle total . Si vos journaux contiennent cette erreur WindowsError: ffffffff80070005: Access is denied., vérifiez les autorisations de sécurité du dossier ou demandez à votre administrateur de le faire.
4. Recherchez les restrictions relatives aux noms de fichiers et aux chemins d'accès.
La reconstruction du journal ne rendra pas synchronisable un nom de fichier invalide. La page officielle ownCloud relative aux noms de fichiers indique que Windows interdit les caractères tels que <, >, :, ", \, |, , ?, et *, et que les noms de fichiers ne peuvent pas se terminer par un espace ou un point. Les noms réservés par Windows, tels que CON, PRN, AUX, , NUL, COM1à COM9, et LPT1à , LPT9peuvent également poser problème.
Pour Windows VFS, ownCloud signale également une limitation courante de 260 caractères pour les composants de chemin, sauf si le système d'exploitation est configuré pour assouplir cette limite. Si seul un fichier profondément imbriqué pose problème, raccourcissez le chemin ou suivez les recommandations de Microsoft concernant la configuration des chemins longs, disponibles dans la documentation d'ownCloud.
5. Ne configurez pas deux moteurs de synchronisation pour qu'ils pointent vers le même répertoire local.
ownCloud déconseille formellement la synchronisation d'un même répertoire local avec un autre outil de synchronisation tel que OneDrive, Dropbox, rsync, Unison ou les fichiers hors connexion de Windows. Ces applications concurrentes peuvent modifier les métadonnées ou les fichiers situés en sous-jacents et, dans le pire des cas, entraîner une perte de données. Si Jordan avait également placé ce répertoire sous un autre service de synchronisation cloud, la solution appropriée aurait consisté à séparer ces répertoires de synchronisation plutôt que de supprimer à répétition le journal ownCloud.
Collectez les journaux si la reconstruction de la base de données ne résout pas le problème.
Si l'erreur CSync persiste après une reconstruction complète, veuillez collecter les journaux autour d'une tentative de synchronisation reproductible. ownCloud indique que le journal de l'application de bureau est souvent l'élément de diagnostic le plus utile.
Dans l'application de bureau 7.1, la journalisation s'active via Paramètres → Avancé → Paramètres de journalisation . Les raccourcis clavier sont F12 sous Windows, Ctrl+L sous Linux et Cmd+L sous macOS. Activez la journalisation dans un dossier temporaire, reproduisez le problème, puis enregistrez les fichiers correspondant à la période concernée.
Vous pouvez également démarrer l'application avec un niveau de journalisation plus détaillé. Par exemple, sous Windows :
Ne publiez pas les journaux générés à la légère. ownCloud vous avertit qu'ils peuvent contenir des noms de fichiers et de dossiers, des métadonnées, des URL de serveur et d'autres informations confidentielles. Partagez-les uniquement avec l'administrateur concerné ou le support ownCloud si nécessaire.
Un chemin de décision compact
Ce que vous voyez
Meilleure prochaine action
Message exact : Erreur CSync inconnue
Quittez ownCloud, supprimez-le ._sync_xxxxxxx.db, redémarrez-le, puis vérifiez les paramètres de sélection des téléchargements.
L'erreur est renvoyée immédiatement.
Vérifiez la connexion au navigateur, l'URL du serveur, le proxy et la compatibilité des versions client/serveur.
Seuls certains fichiers échouent
Vérifiez les règles relatives aux fichiers ignorés, les caractères interdits, les noms réservés sous Windows et la longueur du chemin d'accès.
Windows VFS affiche un refus d'accès.
Vérifiez que l'utilisateur propriétaire dispose d'un contrôle total sur le dossier de synchronisation.
La synchronisation s'arrête lorsque le stockage est plein.
Libérez de l'espace disque local et réessayez.
La cause reste inconnue.
Capturez un journal d'application de bureau reproductible et examinez-le en privé.
Note de version pour 2026
Il est conseillé de vérifier les informations de version avant de tenter de résoudre le problème par une mise à niveau. L'application de bureau ownCloud 7.1.1 a été publiée en septembre 2026, mais la gamme 7.x est destinée à ownCloud Infinite Scale. Les notes de version d'ownCloud indiquent que les utilisateurs d'ownCloud Classic Server 10 ou 11 doivent rester sur la gamme 6.x de l'application de bureau. Une mise à niveau majeure incompatible peut engendrer un autre problème de connexion au lieu de résoudre l'erreur CSync.
En résumé
Pour résoudre l' erreur CSync inconnue , commencez par suivre la procédure de réparation simplifiée décrite dans la documentation ownCloud : fermez complètement l'application de bureau, affichez les fichiers cachés, supprimez le ._sync_xxxxxxx.dbjournal concerné et redémarrez. Cette opération réinitialise l'état de la synchronisation locale et ne vous autorise pas à supprimer des données utilisateur. Si le problème persiste, vérifiez la connectivité, l'espace disque, les permissions, les règles de nommage des fichiers, les logiciels de synchronisation concurrents et les journaux, dans cet ordre.