Файл не открывается: Get Info, Repair, а затем перестаньте гадать
Когда PDF не открывается, выполните Get Info для проверки, затем Repair для перестройки структуры. Это восстановление xref, а не клон настольного Recovery Toolbox.

PDF, который не открывается, обычно страдает проблемой структуры (сломанная таблица перекрёстных ссылок, обрезанная загрузка, искажённые объекты), а не отсутствующим изображением страницы, которое можно перерисовать вручную. Гадание через OCR, сжатие или конвертацию тратит время, пока файл не начнёт разбираться.
Сначала Get Info
Get Info (POST /api/v1/security/get-info-on-pdf) возвращает отчёт JSON: FileSize, PageCount, Encrypted, поля словаря Info, когда они есть (title, author, subject, creator, producer), Version PDF, простой список Pages и признак того, найден ли корень документа. Используйте его как предварительную проверку:
- Encrypted: true означает, что до большинства правок нужен авторизованный Unlock; ремонт сам по себе не взламывает пароли.
- PageCount / FileSize выглядят разумно, но ваш настольный просмотрщик всё равно падает: далее попробуйте структурный Repair.
- Сам вызов не может загрузить байты: файл может быть слишком повреждён для чистого прохода Info; всё равно попробуйте Repair на копии.
Get Info не перезаписывает PDF. Он говорит, что видит парсер, чтобы вы перестали считать любой сбой поводом «нужен OCR» или «нужно сжатие».
Затем Repair (структурная перестройка через qpdf)
Repair PDF (POST /api/v1/misc/repair) перезаписывает файл через qpdf, чтобы просмотрщики снова могли его открыть, когда уцелело достаточно объектов. Когда это удаётся, предполагаемое содержимое страниц сохраняется; работа идёт с картой файла (xref / объектные потоки), а не с форензик-восстановлением удалённых черновиков.
Repair — это не:
- OCR / очистка сканов (файл открывается, но текст в нём только изображением): используйте OCR, который здесь возвращает текст Markdown, а не слой поиска в PDF
- Удаление пароля: используйте Unlock
- Ремонт шрифтов или «сделать файл снова редактируемым»
- Клон продукта для Windows «Recovery Toolbox for PDF»
О различии бренда и канала (онлайн-структурный ремонт против запросов о настольном «recovery toolbox») читайте в статье Ремонт PDF онлайн против запросов о Recovery Toolbox.
Дерево решений «перестаньте гадать»
- Просмотрщик не может открыть файл: Get Info, затем Repair.
- Файл открывается, но выделение и поиск на скане не работают: OCR для текста Markdown; при необходимости Сжатие копии, если размер остаётся проблемой (Из пачки сканов: OCR, затем Compress).
- Файл открывается, таблицы экспортируются как 204: колонки не обнаружены; см. Пустой экспорт таблиц (204).
- Тот же ремонт из скрипта или агента:
POST /api/v1/misc/repairчерез Разработчикам. ОтправляйтеIdempotency-Key, если ваш клиент повторяет загрузки (Idempotency-Key).
Чего «отремонтированный» файл всё равно не исправит
Успешный Repair означает, что просмотрщик снова может открыть файл. Это не значит:
- Что каждое изображение страницы восстановлено из ничего (отсутствующие объекты остаются отсутствующими)
- Что текст на скане стал выделяемым (это OCR → Markdown здесь)
- Что шифрование исчезло (Unlock с известным паролем)
- Что таблицы начнут экспортироваться (по-прежнему нужен колоночный текст; 204 означает, что его нет)
Если после Repair Get Info показывает разумное число страниц, но страница пуста, структура восстановилась, а содержимое этой страницы может оставаться пустым или обрезанным в исходных байтах.
Храните повреждённый оригинал
Держите повреждённый оригинал рядом с любым отремонтированным производным файлом. Если Repair не может восстановить достаточно структуры, честный итог — «байты потеряны», а не ещё один случайный инструмент из каталога. Сжатие или конвертация файла, который всё ещё не разбирается, не изобретает пропавшие объекты.
Сравните намерение канала (онлайн-структурный ремонт против запросов о бренде настольного «recovery toolbox») в статье Ремонт PDF онлайн против запросов о Recovery Toolbox, если именно так вы нашли инструмент. Аккаунт для пути через браузер на инструментах каталога не требуется.