Сначала сохраните исходный документ, затем определите, произошла ли ошибка при преобразовании PDF-файла в ONLYOFFICE или при окончательной загрузке в браузере. Если редактор сообщает об ошибке преобразования, проверьте журналы сервера документов и убедитесь, что сервер может получить доступ к исходному файлу. Если преобразование прошло успешно, но браузер отображает сообщение «Загрузка не удалась», проверьте состояние загрузки браузера, права доступа к сайту и доступное дисковое пространство.
Показательный сценарий: Представьте, что Джордан, администратор, использующий самостоятельно установленный редактор ONLYOFFICE Docs, выбирает «Файл» > «Скачать как» > «PDF» для отчета по проекту. Редактор выдает ошибку, и PDF-файл не появляется. Это гипотетический пример, а не проверенный случай; один и тот же симптом может возникать на разных этапах, поэтому проверки ниже проводятся после остановки процесса.
Перед устранением неполадок используйте функцию «Сохранить» или Ctrl+S для сохранения текущих изменений. В онлайн-редакторе документов ONLYOFFICE указывает путь экспорта PDF как «Файл» > «Скачать как» > «PDF». Редактор может сначала подготовить PDF-файл, а затем передать результат в браузер, поэтому неудачная загрузка в браузер не всегда означает, что само преобразование не удалось.
Используйте тот же отчет для выполнения одной контролируемой повторной попытки. Обратите внимание, отображает ли редактор диалоговое окно с ошибкой, создает ли браузер запись о неудачной загрузке и затрагивает ли проблема только этот файл или все файлы. Избегайте многократного нажатия кнопки «Экспорт»: дублирующиеся задания затрудняют сопоставление метки времени с соответствующей записью в журнале сервера.
Откройте страницу загрузок в браузере и проверьте неудавшийся файл. Попробуйте еще раз. Убедитесь, что браузер не блокирует загрузки с сайта ONLYOFFICE, что подтверждение загрузки ожидает в другой вкладке и что на целевом диске достаточно свободного места. Если вы управляете браузером, протестируйте тот же сохраненный документ в другом браузере или в чистом профиле браузера. Если это сработает, сосредоточьтесь на настройках браузера, расширениях или локальном программном обеспечении безопасности; пока не меняйте конфигурацию сервера документов.
В гипотетическом случае, описанном Джорданом, браузер должен завершить подготовку PDF-файла, но в списке загрузок будет отображаться сообщение о сбое сети или проблеме с правами доступа. В качестве практического запасного варианта можно использовать меню «Файл» > «Печать» и выбрать пункт назначения «Сохранить в PDF» в браузере или операционной системе, если таковой имеется. Проверьте полученные страницы, шрифты и ссылки, поскольку результат печати может отличаться от прямого экспорта PDF-файла из редактора. Этот обходной путь не исправляет ошибку преобразования на стороне сервера.
При самостоятельной установке попросите администратора проверить журналы Document Server во время повторной попытки. Журналы ONLYOFFICE для Linux находятся в папке /var/log/onlyoffice/documentserver; для Docker журналы доступны внутри контейнера по этому пути, а вывод Docker также можно просмотреть с помощью команды docker logs <container>. Точный компонент и текст журнала зависят от установки и версии. Ищите ошибки преобразования, тайм-ауты, неудачные запросы, коды состояния HTTP или ошибки DNS и подключения. Не публикуйте полные строки журнала, если они содержат закрытые URL-адреса, токены доступа, имена пользователей или имена документов.
Если журналы или API выявляют проблему с загрузкой исходного файла, убедитесь, что сервер документов может получить доступ к URL-адресу исходного документа из своего сетевого пространства имен. Администратор может проверить авторизованный URL-адрес с сервера или контейнера и проверить DNS, маршрутизацию, правила брандмауэра, настройки прокси, сертификаты TLS и ответ приложения хранилища. URL-адрес, открывающийся в браузере на рабочем столе, может быть недоступен с сервера документов. И наоборот, если исходный файл загружается успешно, но преобразование не удается, исследуйте ошибку преобразователя, а не меняйте сетевой доступ.
Для рабочих процессов преобразования на основе API используйте возвращаемый код ошибки, чтобы сузить круг проблем. ONLYOFFICE определяет ошибку преобразования -4как ошибку загрузки входного файла, -2как превышение времени ожидания, -3как ошибку преобразования и -8как недействительный токен. Эти коды специфичны для ответа API преобразования; общее сообщение «Загрузка не удалась» в редакторе само по себе не доказывает, что преобразование PDF-файла вернуло один из этих кодов.
Если сбой происходит только с файлами, хранящимися на одной подключенной платформе, проверьте адрес сервера документов и внутренние настройки доступа коннектора. Служба редактирования должна иметь возможность получить файл из своей системы хранения. В документации по устранению неполадок ONLYOFFICE ошибка «Загрузка не удалась» во время загрузки редактора описывается как невозможность службы редактирования получить доступ к URL-адресу файла. Это руководство полезно, когда отчет не может открыться или загрузиться; если редактор открывается нормально, а сбой происходит только с экспортом в PDF, сначала проверьте этап экспорта или загрузки.
Если API сообщает о недействительном токене, сравните секретный ключ JWT, заголовок и конфигурацию токена с обеих сторон. Не отключайте JWT в качестве быстрого решения. Если API указывает на ограничение размера, сравните размер файла с ограничениями, настроенными в вашей системе развертывания. Для большого файла или неподдерживаемого/поврежденного источника может потребоваться другое решение; изменение браузера или сети не устранит ограничение на конвертацию или поврежденный документ.
Включайте отладочное логирование только в том случае, если обычные журналы не показывают, где заканчивается запрос, и отключайте его после сбора необходимых доказательств. Отладочные журналы могут содержать конфиденциальные данные запроса. Следуйте инструкциям ONLYOFFICE для вашего типа установки и предоставьте администратору или службе поддержки отредактированный фрагмент журнала, вместо того чтобы раскрывать URL-адреса документов или токены.
В документации ONLYOFFICE различают этапы загрузки PDF-файлов и ошибки преобразования. Для получения подробной информации, соответствующей вашей конфигурации, обратитесь к инструкциям по загрузке и печати в редакторе документов , официальному руководству по устранению неполадок интеграции , кодам ошибок API преобразования и руководству по ведению журналов отладки .
Отделите проблемы с загрузкой из браузера от ошибок преобразования на стороне сервера и используйте правильную проверку журнала или доступа, чтобы экспорт в PDF работал корректно.
Сопоставьте секретный JWT-код, используемый ONLYOFFICE Docs и Nextcloud, безопасно примените его для установок Docker или Linux и проверьте соединение, не ослабляя аутентификацию.
Установите ONLYOFFICE Workspace Community на Ubuntu 24.04 с помощью официального скрипта Docker, проверьте требования к серверу, при необходимости пропустите почтовую программу и безопасно проверьте работу портала.
Настройка соответствующих секретных JWT-токенов для ONLYOFFICE Docs и его коннектора с безопасными шагами для пакетов Linux, развертывания Docker и проверки.
Добавьте встроенный редактор ONLYOFFICE Docs логотип вашей компании и цвета интерфейса с помощью пользовательского файла темы и конфигурации редактора. См. ограничения по версиям и проверки развертывания.
Отслеживайте изменения в Writer, сохраняйте редактируемый исходный файл ODT и проверяйте экспортированный файл DOCX в Word перед отправкой.
Следуйте процедуре SP7 от SUSE, чтобы включить режим FIPS, безопасно перезагрузите систему, проверьте активную политику и убедитесь, что ваши требования к соответствию стандартам предусматривают использование проверенных модулей.
Сравните YaST и cryptsetup для нового зашифрованного тома данных SLES, выберите LUKS1 или LUKS2 и проверьте безопасное разблокирование и монтирование.
Настройте RMT на SLES 15, создайте зеркальные копии репозиториев с правами доступа и проверьте регистрацию HTTPS и доступ к пакетам с тестового клиента.
Подключите SLES 15 к Active Directory с помощью системы управления входом в систему на основе SSSD от YaST, затем проверьте поиск в каталоге, вход в домен и билеты Kerberos.
