Dépannage de la synchronisation Obsidian

Symptômes → causes probables → pistes à essayer.

La connexion échoue

La connexion utilise un flux d’appareil : le plugin affiche un court code utilisateur, ouvre la page de vérification du serveur dans ton navigateur et interroge le serveur jusqu’à ce que tu approuves. Aucun jeton n’est renvoyé via le schéma d’URL obsidian://.

• La page de vérification ne s’ouvre jamais. Copie le code utilisateur affiché dans la boîte de dialogue de connexion et ouvre l’URL de vérification manuellement, puis colle le code. Vérifie que ton URL Engram (Cloud ou Auto-hébergement) est correcte dans les paramètres du plugin.
• Approuvé dans le navigateur mais le plugin ne confirme jamais. Le plugin interroge le serveur pour obtenir le jeton après ton approbation ; laisse-lui quelques secondes. S’il ne confirme toujours pas, ferme la boîte de dialogue et relance la connexion depuis la page de paramètres du plugin.
• « Invalid token » après la connexion. Ta session a peut-être expiré. Déconnecte-toi depuis la page de paramètres du plugin puis reconnecte-toi.

La synchronisation reste bloquée sur « Pending push: N »

• Consulte le journal Centre de synchronisation → Recent activity pour la dernière erreur.
• Si le serveur est joignable mais que les envois renvoient 409 (conflit de version), c’est probablement un vrai conflit ; ouvre la file des conflits.
• Si les envois renvoient 413, la note dépasse la taille maximale par note. Découpe-la.
• Si les envois renvoient 429, tu es limité en débit. Attends une minute et réessaie, ou vérifie ton offre d’abonnement.

L’application web affiche un contenu périmé

• Recharge la page une fois. L’application web s’abonne aux mises à jour en direct, mais le chargement initial est mis en cache.
• Vérifie que le plugin dans Obsidian affiche une heure de Last sync postérieure à ta dernière modification.

Une note précise ne se synchronise pas

• Vérifie que le chemin ne contient pas de caractères interdits (surtout sur mobile, voir Mobile).
• Vérifie la taille de la note. Il existe une taille maximale par note.
• Ouvre le Centre de synchronisation, trouve la note dans Pending push, survole-la pour voir la raison de l’erreur.

Le plugin ne se charge pas après une mise à jour

• Ouvre la console développeur d’Obsidian (Ctrl/Cmd+Shift+I) et cherche des erreurs mentionnant engram-vault-sync.
• Essaie de désactiver puis de réactiver le plugin dans Paramètres → Plugins communautaires.
• Si une version livrée est défectueuse, signale le bug sur engram-app/Engram-obsidian et désinstalle temporairement le plugin. La version précédente n’est pas récupérable depuis Obsidian une fois que la mise à jour du répertoire communautaire est installée.

Où signaler les bugs

Tickets de engram-app/Engram-obsidian. Indique :

• La version d’Obsidian, la plateforme (ordinateur/iOS/Android) et la version du système
• La version du plugin Engram
• Une capture d’écran du journal Centre de synchronisation → Recent activity
• Les étapes pour reproduire