Strona główna
» Jak
»
Śledź wywołanie zwrotne zapisu, gdy ONLYOFFICE nie zapisuje w NextCloud
Ś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.
Wskaźnik zapisania pliku przez edytora jest przydatny, ale pozwala upewnić się, że zaktualizowany plik jest obecny w usłudze NextCloud po zamknięciu sesji edycji.
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.
Wewnętrzne pola adresowe łącznika służą do tras serwer-serwer, gdy publiczne adresy URL nie są dostępne z obu serwerów.
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:
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.
Ten przykład koncepcyjny pokazuje, dlaczego przekierowanie w ścieżce wywołania zwrotnego ma znaczenie; do diagnozy trasy użyj rzeczywistych dzienników Serwera dokumentów.
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.
Po naprawie sprawdź, czy zaktualizowany plik pojawia się w oczekiwanym folderze Nextcloud i ma najnowszy czas modyfikacji.
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.
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.