Traceer de opslagcallback wanneer ONLYOFFICE niet opslaat in Nextcloud

Hypothetisch voorbeeld: Mina bewerkt een projectplan in ONLYOFFICE vanuit een Nextcloud-map. De editor opent en accepteert haar wijzigingen, maar Nextcloud meldt later: "Document kon niet worden opgeslagen." Dit voorbeeld is illustratief en geen verslag van een echte test. Houd in deze situatie de editor open, bewaar een lokale kopie van het niet-opgeslagen werk en controleer of ONLYOFFICE Docs de opslagcallback van Nextcloud rechtstreeks kan bereiken. Gebruik vervolgens de logboeken om onderscheid te maken tussen een fout in de callback-routering en een probleem met de Nextcloud-opslag of -toegangsrechten.

1. Bescherm de wijzigingen van Mina voordat u problemen oplost.

Sluit of vernieuw de editor niet zolang er nog wijzigingen in staan ​​die Nextcloud niet heeft opgeslagen. Gebruik de optie ' Downloaden als' in de editor om een ​​lokale herstelkopie te bewaren, als de editor nog steeds reageert. Noteer het tijdstip en de bestandsnaam van de mislukte opslagpoging, zodat de beheerder de logbestanden kan vergelijken.

Test een klein DOCX-bestand in een standaard Nextcloud-map. Als het bestand wordt opgeslagen, controleer dan de machtigingen, de deelstatus, de opslag of het formaat van het originele bestand. Als alle bestanden niet worden opgeslagen, begin dan met de gedeelde callback-route en de serverstatus.

2. Controleer de callbackfunctie voor het opslaan tussen servers.

ONLYOFFICE Docs verstuurt een POST-verzoek naar de callback-URL die door de Nextcloud-connector wordt verstrekt. Nextcloud haalt vervolgens het bewerkte bestand op en werkt de opgeslagen versie bij. De editor kan normaal openen, maar kan niet opslaan als Document Server geen POST-verzoek naar Nextcloud kan terugsturen.

Reproduceer het probleem met een testbestand en vergelijk vervolgens de DocService- en Nextcloud-logbestanden op dat moment. Op Linux bevinden de ONLYOFFICE-logbestanden zich in de map /var/log/onlyoffice/documentserver/; in Docker kunt u de containerlogbestanden of de gekoppelde logmap controleren. Het standaard logbestand van Nextcloud bevindt zich nextcloud.login de data-directory, tenzij log_typeof logfiledit wijzigt.

• 301, 302 of 308: URL-omleidingen met callback, vaak tussen HTTP/HTTPS-servers of hostnamen.
• Time-out of DNS-fout: De documentenserver kan de URL niet oplossen of bereiken.
• 403 of 404: een proxy, toegangsregel, padwijziging of hostinstelling kan het verzoek afwijzen.
• Nextcloud-opslagfout: de callback is aangekomen; controleer het quotum, de machtigingen, de opslagstatus of de vergrendelingen.

3. Corrigeer de URL of proxyroute wanneer de callback wordt omgeleid.

Open in Nextcloud Instellingen > Beheer > ONLYOFFICE . Controleer of het openbare adres van ONLYOFFICE Docs de URL is die de browsers van gebruikers moeten laden. Als de twee servers elkaar niet kunnen bereiken via hun openbare adressen, stel dan de gedocumenteerde interne velden in: ONLYOFFICE Docs-adres voor interne verzoeken van de server en Serveradres voor interne verzoeken van ONLYOFFICE Docs . Het eerste adres moet werken van Nextcloud naar Document Server; het tweede adres moet werken van Document Server naar Nextcloud.

In Mina's hypothetische configuratie gebruikt de callback http://cloud.example.comHTTPS en wordt erdoor doorgestuurd. Configureer het uiteindelijke HTTPS-adres direct en zorg ervoor dat DNS, firewallregels en certificaatvertrouwen ervoor zorgen dat Document Server dit adres kan bereiken. De proxy moet de callback doorgeven aan Nextcloud zonder het schema, de hostnaam of het pad door te sturen. De voorbeeldhostnaam is niet bedoeld voor echte installaties.

De verbindingscontrole van ONLYOFFICE kan helpen bij het verifiëren van geconfigureerde serviceadressen:

sudo -u www-data php occ onlyoffice:documentserver --check

Voer het uit vanuit de Nextcloud-directory als het juiste webserveraccount. Een succesvolle controle bewijst niet dat de callback POST werkt. Een handmatig HEAD-verzoek of een browserpagina op dezelfde hostnaam is evenmin een bewijs.

4. Volg het bewijsmateriaal naar Nextcloud-opslag.

Als de callback Nextcloud bereikt, maar het bestand nog steeds niet wordt bijgewerkt, controleer dan het Nextcloud-logboek op het bijbehorende verzoek. Controleer of de gebruiker bewerkingsrechten heeft, of de opslaglocatie beschikbaar is, of het account de quotumlimiet niet heeft overschreden en of het datavolume voldoende vrije ruimte en inodes heeft. Als het probleem een ​​gedeeld bestand betreft, vraag dan of een andere gebruiker of synchronisatieclient het bestand tegelijkertijd wijzigt en test het vervolgens met een kopie in een privémap.

Nextcloud's transactionele bestandsvergrendeling coördineert schrijfbewerkingen; schakel deze niet uit als noodoplossing. Als logboeken wijzen op vergrendelings- of databasefouten, controleer dan de vergrendelingsbackend en de Redis- of Valkey-service. Verwijder geen oc_file_locksrijen en vergrendel geen bestanden, aangezien dit actieve schrijfbewerkingen kan verstoren.

Als een test met een standaardmap werkt, maar een extern opgeslagen bestand niet, onderzoek dan de beschikbaarheid en de authenticatiemodus van die koppeling. ONLYOFFICE documenteert beperkingen voor sommige externe opslagmodi; wijzig geen inloggegevens totdat u de koppeling hebt geïsoleerd.

5. Controleer het volledige opslagpad

Nadat je een instelling hebt gewijzigd, breng je een aparte wijziging aan in een klein testdocument, wacht je tot het opslaan is voltooid en sluit je het document vervolgens af en open je het opnieuw vanuit Nextcloud. Controleer of de wijziging is opgeslagen en of de bijbehorende logboeken geen omleidingen, verbindingsfouten of opslagproblemen weergeven.

Als de test slaagt maar het origineel nog steeds niet werkt, controleer dan de machtigingen, de externe koppeling of gelijktijdige bewerkingen. Als alle callbacks mislukken, bewaar dan de lokale kopie en escaleer het probleem met de tijdstempel, HTTP-status, versies en geanonimiseerde logbestanden. Verwijder JWT's, cookies, ondertekende URL's en persoonlijke bestandsnamen.

Deze stappen pakken de meest voorkomende oorzaken van een opslagfout aan, zoals problemen met callbacks, routering en opslag. De exacte oplossing hangt af van het eerste foutpunt in de logboeken; een succesvolle verbindingscontrole alleen is onvoldoende om de volledige opslagprocedure te garanderen.

Officiële referenties

• ONLYOFFICE Nextcloud-integratie: serveradressen, callback-flow en verbindingscontrole
• Probleemoplossing voor ONLYOFFICE-documenten: opslagfouten en bereikbaarheid van callbacks
• Nextcloud 35 Beheerhandleiding: transactionele bestandsvergrendeling
• Nextcloud-beheerhandleiding: logboekconfiguratie

Documentatie gecontroleerd op 9 oktober 2026. Connectorvelden en logbestemmingen kunnen variëren afhankelijk van de geïnstalleerde app-versie en de implementatieconfiguratie.