Śledź wywołanie zwrotne zapisu, gdy ONLYOFFICE nie zapisuje w NextCloud

Hipotetyczny przykład: Mina edytuje plan projektu w aplikacji ONLYOFFICE z folderu Nextcloud. Edytor otwiera go i akceptuje zmiany, ale Nextcloud zgłasza później komunikat „Nie można zapisać dokumentu”. Ten przykład jest ilustracją, a nie raportem z rzeczywistego testu. W takiej sytuacji należy pozostawić edytor otwarty, zachować lokalną kopię niezapisanych prac i sprawdzić, czy aplikacja ONLYOFFICE Docs może bezpośrednio uzyskać dostęp do wywołania zwrotnego zapisu w aplikacji Nextcloud. Następnie należy użyć logów, aby odróżnić błąd routingu wywołania zwrotnego od problemu z pamięcią masową lub uprawnieniami w aplikacji Nextcloud.

1. Chroń zmiany Miny przed rozwiązywaniem problemów

Nie zamykaj ani nie odświeżaj edytora, dopóki zawiera on zmiany, których NextCloud nie zapisał. Użyj opcji „Pobierz jako” w edytorze , aby zachować lokalną kopię zapasową, jeśli edytor nadal działa. Zanotuj czas i nazwę pliku nieudanego zapisu, aby administrator mógł porównać logi.

Przetestuj mały plik DOCX w standardowym folderze Nextcloud. Jeśli się zapisze, skup się na uprawnieniach, stanie udziału, miejscu przechowywania lub formacie oryginalnego pliku. Jeśli wszystkie pliki nie zostaną zapisane, zacznij od współdzielonej trasy wywołania zwrotnego i kondycji serwera.

2. Sprawdź wywołanie zwrotne zapisu między serwerami

ONLYOFFICE Docs wysyła żądanie POST na adres URL wywołania zwrotnego dostarczony przez łącznik Nextcloud. Następnie Nextcloud pobiera edytowany plik i aktualizuje jego zapisaną wersję. Edytor może otworzyć się normalnie, ale nie można go zapisać, jeśli serwer dokumentów nie może przesłać danych z powrotem do Nextcloud.

Odtwórz problem z plikiem testowym, a następnie porównaj logi DocService i Nextcloud w tym czasie. W systemie Linux logi ONLYOFFICE znajdują się w katalogu /var/log/onlyoffice/documentserver/; w Dockerze sprawdź logi kontenera lub zamontowany katalog logów. Domyślny plik logu Nextcloud znajduje się nextcloud.logw katalogu danych, chyba że log_typeużytkownik logfilego zmieni.

• 301, 302 lub 308: przekierowania adresów URL wywołań zwrotnych, często pomiędzy protokołami HTTP/HTTPS lub nazwami hostów.
• Przekroczono limit czasu lub błąd DNS: Serwer dokumentów nie może rozwiązać lub dotrzeć do adresu URL.
• 403 lub 404: serwer proxy, reguła dostępu, przepisanie ścieżki lub ustawienie hosta może odrzucić żądanie.
• Wyjątek magazynu Nextcloud: otrzymano wywołanie zwrotne; sprawdź limit, uprawnienia, stan magazynu lub blokady.

3. Popraw adres URL lub trasę proxy, gdy wywołanie zwrotne zostanie przekierowane

W NextCloud otwórz Ustawienia > Administracja > ONLYOFFICE . Sprawdź, czy publiczny adres DOC w serwisie ONLYOFFICE Docs to adres URL, który powinny wczytywać przeglądarki użytkowników. Jeśli oba serwery nie mogą się ze sobą połączyć za pośrednictwem swoich adresów publicznych, ustaw udokumentowane pola wewnętrzne: Adres DOC w serwisie ONLYOFFICE Docs dla żądań wewnętrznych z serwera i Adres serwera dla żądań wewnętrznych z serwisu ONLYOFFICE Docs . Pierwszy musi działać z serwisu NextCloud do serwera dokumentów, a drugi musi działać z serwera dokumentów do serwisu NextCloud.

W hipotetycznej konfiguracji Miny, wywołanie zwrotne używa http://cloud.example.comprotokołu HTTPS i przekierowuje do niego. Skonfiguruj bezpośrednio końcowy adres HTTPS, a następnie upewnij się, że DNS, reguły zapory sieciowej i zaufanie certyfikatu pozwalają serwerowi dokumentów na dotarcie do niego. Serwer proxy powinien przekazać wywołanie zwrotne do NextCloud bez przekierowywania schematu, nazwy hosta ani ścieżki. Przykładowa nazwa hosta nie jest przeznaczona dla rzeczywistych instalacji.

Sprawdzanie połączenia ONLYOFFICE może pomóc zweryfikować skonfigurowane adresy usług:

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

Uruchom go z katalogu Nextcloud jako odpowiednie konto serwera WWW. Pomyślne sprawdzenie nie dowodzi, że wywołanie zwrotne POST działa. Ręczne żądanie HEAD lub strona przeglądarki pod tą samą nazwą hosta również nie stanowią dowodu.

4. Podążaj za dowodami i przenieś je do magazynu NextCloud

Jeśli wywołanie zwrotne dotrze do Nextcloud, ale plik nadal się nie aktualizuje, sprawdź dziennik Nextcloud pod kątem pasującego żądania. Upewnij się, że użytkownik ma uprawnienia do edycji, miejsce montowania pamięci masowej jest dostępne, konto nie przekracza limitu, a wolumin danych ma wolne miejsce i inody. Jeśli problem dotyczy pliku współdzielonego, zapytaj, czy inny użytkownik lub klient synchronizacji nie zmienia go w tym samym czasie, a następnie przetestuj go z kopią w folderze prywatnym.

Blokada plików transakcyjnych w NextCloud koordynuje zapisy; nie należy jej wyłączać jako szybkiego rozwiązania. Jeśli logi wskazują na błędy blokady lub bazy danych, należy zweryfikować system blokowania oraz usługę Redis lub Valkey. Nie należy usuwać oc_file_lockswierszy ani blokować plików, ponieważ może to zakłócić aktywne zapisy.

Jeśli test standardowego folderu zadziała, ale plik przechowywany zewnętrznie nie, sprawdź dostępność i tryb uwierzytelniania tego montowania. ONLYOFFICE dokumentuje ograniczenia niektórych trybów przechowywania zewnętrznego; unikaj zmiany poświadczeń do czasu odizolowania montowania.

5. Sprawdź pełną ścieżkę zapisu

Po zmianie jednego ustawienia wprowadź wyraźną edycję w małym dokumencie testowym, poczekaj na zakończenie zapisywania, a następnie zamknij i otwórz go ponownie z poziomu NextCloud. Sprawdź, czy zmiana została zachowana, a odpowiadające jej logi nie wykazują żadnych przekierowań, awarii połączenia ani wyjątków dotyczących pamięci masowej.

Jeśli test się powiedzie, ale oryginał nadal nie działa, sprawdź jego uprawnienia, montowanie zewnętrzne lub edycje współbieżne. Jeśli wszystkie wywołania zwrotne zawiodą, zachowaj kopię lokalną i eskaluj problem, uwzględniając znacznik czasu, status HTTP, wersje i wyczyszczone logi. Usuń tokeny JWT, pliki cookie, podpisane adresy URL i nazwy plików osobistych.

Te kroki dotyczą typowych przyczyn błędów zapisu, związanych z wywołaniem zwrotnym, routingiem i przechowywaniem. Dokładne rozwiązanie zależy od pierwszego punktu awarii w logach; samo pomyślne sprawdzenie połączenia nie może potwierdzić poprawności całego procesu zapisu.

Oficjalne źródła

• Integracja ONLYOFFICE Nextcloud: adresy serwerów, przepływ wywołań zwrotnych i sprawdzanie połączenia
• Rozwiązywanie problemów z dokumentami ONLYOFFICE: błędy zapisywania i dostępność wywołania zwrotnego
• Podręcznik administratora NextCloud 35: blokowanie plików transakcyjnych
• Podręcznik administratora NextCloud: konfiguracja rejestrowania

Dokumentacja sprawdzona 9 października 2026 r. Pola łącznika i miejsca docelowe dziennika mogą się różnić w zależności od zainstalowanej wersji aplikacji i konfiguracji wdrożenia.