Plik się nie otwiera: informacje, naprawa, koniec zgadywania
Gdy PDF się nie otwiera, uruchom Get Info, a potem Repair, aby odbudować strukturę. To odzyskiwanie tabeli odsyłaczy, a nie klon Recovery Toolbox.

PDF, który się nie otwiera, to zwykle problem struktury (uszkodzona tabela odsyłaczy, przerwane pobieranie, błędnie zbudowane obiekty), a nie brakujący obraz strony, który dałoby się przerysować ręcznie. Zgadywanie za pomocą OCR, kompresji albo konwersji marnuje czas, dopóki plik nie zacznie się parsować.
Najpierw Get Info
Pobierz informacje (POST /api/v1/security/get-info-on-pdf) zwraca raport JSON: FileSize, PageCount, Encrypted, pola słownika Info, gdy są obecne (title, author, subject, creator, producer), Version PDF, prostą listę Pages oraz informację, czy znaleziono korzeń dokumentu. Użyj tego jako kontroli wstępnej:
- Encrypted: true oznacza, że przed większością edycji potrzebujesz uprawnionego odblokowania; sama naprawa nie łamie haseł.
- PageCount i FileSize wyglądają sensownie, a twoja przeglądarka na komputerze nadal zawodzi: spróbuj najpierw naprawy struktury przez Repair.
- Samo wywołanie nie potrafi wczytać bajtów: plik może być zbyt uszkodzony na czyste przejście Info; mimo to spróbuj Repair na kopii.
Get Info nie przepisuje PDF-a. Mówi, co widzi parser, żebyś przestał traktować każdą awarię jako „potrzebne OCR” albo „potrzebna kompresja”.
Potem Repair, czyli odbudowa struktury przez qpdf
Napraw PDF (POST /api/v1/misc/repair) przepisuje plik przez qpdf, aby przeglądarki znów mogły go otworzyć, gdy wystarczająca liczba obiektów przetrwała. Gdy się to udaje, zamierzona treść stron zostaje zachowana; chodzi o mapę pliku (xref i strumienie obiektów), a nie o odzyskiwanie śledcze usuniętych szkiców.
Repair nie jest:
- czyszczeniem skanu przez OCR (plik się otwiera, ale tekst istnieje tylko jako obraz): użyj OCR, które w tym serwisie zwraca tekst Markdown, a nie przeszukiwalną warstwę PDF,
- usuwaniem hasła: użyj odblokowania,
- naprawą fontów ani „ponownym uczynieniem pliku edytowalnym”,
- klonem produktu dla Windows o nazwie „Recovery Toolbox for PDF”.
O rozróżnieniu marki i kanału (naprawa struktury online a wyszukiwania desktopowego „recovery toolbox”) przeczytasz w Naprawa PDF online a wyszukiwania „Recovery Toolbox”.
Drzewo decyzyjne: koniec zgadywania
- Przeglądarka nie potrafi otworzyć pliku: Pobierz informacje, a potem Napraw.
- Plik się otwiera, ale zaznaczanie i wyszukiwanie na skanie zawodzą: OCR po tekst Markdown; opcjonalnie Compress na kopii, jeśli pozostałym problemem jest rozmiar (Pakiet skanów: OCR, potem kompresja).
- Plik się otwiera, a eksport tabel zwraca 204: nie wykryto kolumn; zobacz Pusty eksport tabeli (204).
- Tej samej naprawy potrzebujesz ze skryptu albo od agenta:
POST /api/v1/misc/repairprzez Dla programistów. DodajIdempotency-Key, jeśli twój klient ponawia przesyłanie (Idempotency-Key).
Czego „naprawiony” plik nadal nie rozwiąże
Udana naprawa oznacza, że przeglądarka może otworzyć plik. Nie oznacza, że:
- każdy obraz strony został odtworzony z niczego (brakujące obiekty pozostają brakujące),
- tekst stał się zaznaczalny na skanie (to OCR i Markdown w tym serwisie),
- szyfrowanie zniknęło (odblokowanie znanym hasłem),
- tabele zaczną się eksportować (nadal potrzebny jest tekst kolumnowy; 204 oznacza, że go nie wykryto).
Jeśli po naprawie Get Info pokazuje sensowną liczbę stron, ale jedna strona jest pusta, struktura została odbudowana, a treść tej strony może nadal być pusta albo ucięta w oryginalnych bajtach.
Zachowaj uszkodzony oryginał
Trzymaj uszkodzony oryginał obok każdego naprawionego pliku pochodnego. Jeśli naprawa nie odzyska wystarczającej struktury, uczciwym wynikiem jest „bajtów już nie ma”, a nie kolejne losowe narzędzie z katalogu. Kompresja albo konwersja pliku, który nadal się nie parsuje, nie wymyśli brakujących obiektów.
Intencję kanału (naprawa struktury online a wyszukiwania marki desktopowego „recovery toolbox”) porównuje Naprawa PDF online a wyszukiwania „Recovery Toolbox”, jeśli właśnie tak trafiłeś na to narzędzie. Ścieżka przeglądarkowa narzędzi z katalogu nie wymaga konta.