Accueil
» Comment faire
»
Suivi du rappel d'enregistrement lorsque ONLYOFFICE ne sauvegarde pas sur Nextcloud
Suivi du rappel d'enregistrement lorsque ONLYOFFICE ne sauvegarde pas sur Nextcloud
Exemple hypothétique : Mina modifie un plan de projet dans ONLYOFFICE depuis un dossier Nextcloud. L’éditeur s’ouvre et accepte ses modifications, mais Nextcloud signale ensuite l’erreur « Impossible d’enregistrer le document ». Cet exemple est purement illustratif et ne correspond pas à un test réel. Dans ce cas, laissez l’éditeur ouvert, conservez une copie locale du document non enregistré et vérifiez si ONLYOFFICE Docs peut accéder directement à la fonction de rappel d’enregistrement de Nextcloud. Utilisez ensuite les journaux pour distinguer un échec de routage de la fonction de rappel d’un problème de stockage ou d’autorisation lié à Nextcloud.
L'indicateur de sauvegarde de l'éditeur est utile, mais vérifiez que le fichier mis à jour est bien présent dans Nextcloud après avoir fermé la session d'édition.
1. Protégez les modifications de Mina avant le dépannage.
Ne fermez pas et n'actualisez pas l'éditeur tant qu'il contient des modifications non enregistrées par Nextcloud. Si l'éditeur reste accessible, utilisez l' option « Télécharger sous » pour conserver une copie de récupération locale. Notez l'heure et le nom du fichier ayant échoué afin que l'administrateur puisse les comparer aux journaux.
Testez un petit fichier DOCX dans un dossier Nextcloud standard. S'il s'enregistre, vérifiez les permissions du fichier d'origine, son statut de partage, son espace de stockage ou son format. Si aucun fichier ne s'enregistre, commencez par vérifier la configuration du serveur de rappel de partage et son état.
2. Vérifiez le rappel d'enregistrement serveur à serveur
ONLYOFFICE Docs envoie une requête POST à l'URL de rappel fournie par le connecteur Nextcloud. Nextcloud récupère alors le fichier modifié et met à jour sa version enregistrée. L'éditeur peut s'ouvrir normalement, mais l'enregistrement échoue si Document Server ne parvient pas à renvoyer de données à Nextcloud.
Reproduisez le problème avec un fichier de test, puis comparez les journaux de DocService et de Nextcloud à ce moment-là. Sous Linux, les journaux ONLYOFFICE se trouvent dans /var/log/onlyoffice/documentserver/le répertoire `/etc/onlyoffice` ; dans Docker, consultez les journaux du conteneur ou le répertoire de journaux monté. Le journal par défaut de Nextcloud se trouve nextcloud.logdans son répertoire de données, sauf si log_type` docker-compose.log` ou logfile`docker-compose.log` le modifie.
301, 302 ou 308 : redirections d’URL de rappel, souvent entre HTTP/HTTPS ou noms d’hôtes.
Délai d'attente dépassé ou erreur DNS : le serveur de documents ne peut pas résoudre ou atteindre l'URL.
403 ou 404 : un proxy, une règle d’accès, une réécriture de chemin ou un paramètre d’hôte peut rejeter la requête.
Exception de stockage Nextcloud : le rappel est arrivé ; vérifiez le quota, les autorisations, l’état du stockage ou les verrous.
Les champs d'adresse interne du connecteur sont destinés aux routes serveur à serveur lorsque les URL publiques ne sont pas accessibles depuis les deux serveurs.
3. Corrigez l'URL ou la route proxy lorsque le rappel est redirigé.
Dans Nextcloud, ouvrez Paramètres > Administration > ONLYOFFICE . Vérifiez que l'adresse publique ONLYOFFICE Docs correspond bien à l'URL que les navigateurs des utilisateurs doivent charger. Si les deux serveurs ne peuvent pas communiquer via leurs adresses publiques, configurez les champs internes suivants : Adresse ONLYOFFICE Docs pour les requêtes internes du serveur et Adresse du serveur pour les requêtes internes d'ONLYOFFICE Docs . La première adresse doit être fonctionnelle de Nextcloud vers le serveur de documents ; la seconde, du serveur de documents vers Nextcloud.
Dans la configuration hypothétique de Mina, la fonction de rappel utilise http://cloud.example.comHTTPS et y redirige. Configurez directement l'adresse HTTPS finale, puis assurez-vous que le DNS, les règles de pare-feu et la confiance du certificat permettent au serveur de documents d'y accéder. Le proxy doit transmettre la fonction de rappel à Nextcloud sans modifier son schéma, son nom d'hôte ni son chemin. Le nom d'hôte utilisé à titre d'exemple n'est pas destiné aux installations réelles.
La vérification de connexion d'ONLYOFFICE peut aider à vérifier les adresses de service configurées :
Exécutez-le depuis le répertoire Nextcloud avec le compte serveur web approprié. Un test réussi ne prouve pas que la requête POST de rappel fonctionne. Une requête HEAD manuelle ou l'ouverture d'une page web depuis le même nom d'hôte ne constituent pas non plus une preuve.
Cet exemple conceptuel montre pourquoi une redirection dans le chemin de rappel est importante ; utilisez les journaux réels du serveur de documents pour diagnostiquer votre route.
4. Suivez les preuves dans le stockage Nextcloud
Si la requête parvient à Nextcloud mais que le fichier ne se met toujours pas à jour, consultez le journal de Nextcloud pour trouver la requête correspondante. Vérifiez que l'utilisateur dispose des droits de modification, que le point de montage du stockage est disponible, que le compte n'a pas dépassé son quota et que le volume de données dispose d'espace libre et d'inodes suffisants. Si le problème concerne un fichier partagé, vérifiez si un autre utilisateur ou client de synchronisation le modifie simultanément, puis effectuez un test avec une copie dans un dossier privé.
Le verrouillage transactionnel des fichiers de Nextcloud coordonne les écritures ; ne le désactivez pas pour résoudre le problème rapidement. Si les journaux signalent des erreurs de verrouillage ou de base de données, vérifiez le système de verrouillage et le service Redis ou Valkey. Ne supprimez pas oc_file_locksde lignes ni de fichiers de verrouillage, car cela pourrait interrompre les écritures en cours.
Si un test sur un dossier standard fonctionne mais qu'un fichier stocké sur un périphérique externe échoue, vérifiez la disponibilité et le mode d'authentification du point de montage. ONLYOFFICE documente les limitations de certains modes de stockage externe ; évitez de modifier les informations d'identification tant que vous n'avez pas isolé le point de montage.
Après la réparation, vérifiez que le fichier mis à jour apparaît bien dans le dossier Nextcloud prévu et que sa date de modification est la plus récente.
5. Vérifiez le chemin d'enregistrement complet
Après avoir modifié un paramètre, effectuez une modification distincte dans un petit document de test, attendez la fin de l'enregistrement, puis fermez et rouvrez le document depuis Nextcloud. Vérifiez que la modification est bien prise en compte et que les journaux correspondants ne signalent aucune redirection, aucun échec de connexion ni aucune exception de stockage.
Si le test réussit mais que le fichier original présente toujours une erreur, vérifiez ses permissions, les points de montage externes et les modifications simultanées. Si tous les rappels échouent, conservez la copie locale et transmettez l'alerte en fournissant l'horodatage, le statut HTTP, les versions et les journaux anonymisés. Masquez les jetons JWT, les cookies, les URL signées et les noms de fichiers personnels.
Ces étapes permettent de résoudre les problèmes courants liés aux rappels, au routage et au stockage, à l'origine d'une erreur d'enregistrement. La solution exacte dépend du premier point d'erreur relevé dans les journaux ; une vérification de connexion réussie ne suffit pas à garantir le bon déroulement de l'enregistrement.
Documentation vérifiée le 9 octobre 2026. Les champs du connecteur et les destinations des journaux peuvent varier en fonction de la version de l'application installée et de la configuration de déploiement.