ONLYOFFICE PDF 내보내기 실패 원인 추적하기

먼저 원본 문서를 저장한 다음, 오류가 ONLYOFFICE의 PDF 변환 과정에서 발생하는지 아니면 브라우저의 최종 다운로드 단계에서 발생하는지 확인하십시오. 편집기에서 변환 오류가 보고되면 문서 서버 로그를 확인하고 서버가 원본 파일에 접근할 수 있는지 확인하십시오. 변환은 성공했지만 브라우저에 "다운로드 실패" 메시지가 표시되면 브라우저의 다운로드 상태, 사이트 권한 및 사용 가능한 디스크 공간을 확인하십시오.

예시 시나리오: 관리자인 조던이 자체 호스팅 ONLYOFFICE Docs 편집기를 사용하여 프로젝트 보고서를 PDF로 다운로드하려고 합니다. 편집기에 오류가 표시되고 PDF 파일이 생성되지 않습니다. 이는 가상의 예시이며 실제 테스트 사례는 아닙니다. 동일한 증상이 프로세스의 여러 단계에서 발생할 수 있으므로 아래의 점검 사항은 프로세스가 중단되는 시점을 기준으로 합니다.

1. 오류 발생 원인을 보호하고 오류를 한 번만 재현하십시오.

문제 해결을 시작하기 전에 저장 또는 Ctrl+S를 눌러 현재 편집 내용을 저장하십시오. 온라인 문서 편집기에서 ONLYOFFICE는 파일 > 다운로드 > PDF를 통해 PDF 내보내기 경로를 안내합니다. 편집기가 먼저 PDF를 준비한 후 브라우저로 결과를 전송할 수 있으므로 브라우저 다운로드 실패가 항상 변환 자체의 실패를 의미하는 것은 아닙니다.

동일한 보고서를 사용하여 한 번의 제어된 재시도를 수행하십시오. 편집기에 오류 대화 상자가 표시되는지, 브라우저에 다운로드 실패 항목이 생성되는지, 문제가 이 파일에만 영향을 미치는지 아니면 모든 파일에 영향을 미치는지 확인하십시오. 내보내기 버튼을 반복적으로 클릭하지 마십시오. 작업이 중복되면 타임스탬프와 해당 서버 로그 항목을 일치시키기가 더 어려워집니다.

2. 브라우저에 PDF 다운로드 실패 오류가 표시되는 경우

브라우저의 다운로드 페이지를 열고 다운로드에 실패한 항목을 확인하세요. 한 번 더 시도해 보세요. 브라우저가 ONLYOFFICE 사이트에서 다운로드를 차단했는지, 다른 탭에 다운로드 확인 메시지가 표시되는지, 대상 드라이브에 충분한 여유 공간이 있는지 확인하세요. 브라우저를 관리하는 경우, 현재 사용 중인 다른 브라우저나 깨끗한 브라우저 프로필에서 동일한 저장된 문서를 테스트해 보세요. 해당 브라우저에서 다운로드가 성공하면 브라우저 설정, 확장 프로그램 또는 로컬 보안 소프트웨어 문제를 중점적으로 살펴보세요. 아직 문서 서버 구성을 변경하지 마세요.

조던의 가상 사례는 편집기가 PDF 생성을 완료했지만 다운로드 목록에 네트워크 오류 또는 권한 오류가 표시되는 경우 브라우저에 문제가 있음을 나타냅니다. 실용적인 대안으로는 파일 > 인쇄를 사용하고 브라우저 또는 운영 체제의 "PDF로 저장" 옵션을 선택하는 것입니다. 인쇄 출력물은 편집기에서 직접 내보낸 PDF와 다를 수 있으므로 결과 페이지, 글꼴 및 링크를 확인하십시오. 이 해결 방법은 서버 측 변환 오류를 수정하지는 않습니다.

3. 변환 또는 소스 검색이 실패하는 경우

자체 호스팅 설치의 경우, 관리자에게 재시도 시점에 문서 서버 로그를 확인해 달라고 요청하십시오. ONLYOFFICE는 Linux 로그를 / /var/log/onlyoffice/documentserveretc/ docker logs <container>online/log/document ...

로그 또는 API에서 소스 다운로드 문제가 확인되면 문서 서버가 자체 네트워크 네임스페이스에서 소스 문서 URL에 접근할 수 있는지 확인하십시오. 관리자는 서버 또는 컨테이너에서 승인된 URL을 테스트하고 DNS, 라우팅, 방화벽 규칙, 프록시 설정, TLS 인증서 및 스토리지 애플리케이션의 응답을 확인할 수 있습니다. 데스크톱 브라우저에서 열리는 URL이라도 문서 서버에서는 접근할 수 없을 수 있습니다. 반대로 소스 다운로드는 성공했지만 변환이 실패한 경우 네트워크 액세스를 변경하기보다는 변환 오류를 조사해야 합니다.

API 기반 변환 워크플로의 경우, 반환된 오류 코드를 사용하여 문제의 원인을 좁히세요. ONLYOFFICE에서는 변환 오류를 -4입력 파일 다운로드 오류, -2시간 초과, -3변환 오류 및 -8유효하지 않은 토큰으로 정의합니다. 이러한 코드는 변환 API 응답에 특정한 코드이며, 편집기에 표시되는 일반적인 "다운로드 실패" 메시지만으로는 PDF 변환 과정에서 이러한 오류 중 하나가 발생했음을 입증할 수 없습니다.

4. 증거가 있을 경우에만 접근 권한, 사용 권한 및 크기를 확인하십시오.

연결된 플랫폼 중 하나에 저장된 파일만 오류가 발생하는 경우, 커넥터의 문서 서버 주소와 내부 액세스 설정을 확인하십시오. 편집 서비스는 저장 시스템에서 파일을 가져올 수 있어야 합니다. ONLYOFFICE의 문제 해결 문서에서는 편집기 로딩 중 "다운로드 실패" 오류가 편집 서비스가 파일 URL에 액세스할 수 없기 때문이라고 설명합니다. 이 지침은 보고서를 열거나 로드할 수 없는 경우에 유용합니다. 편집기는 정상적으로 열리지만 PDF 내보내기만 실패하는 경우에는 내보내기 또는 다운로드 단계를 먼저 점검하십시오.

API에서 유효하지 않은 토큰이 보고되면 양쪽의 JWT 비밀 키, 헤더 및 토큰 구성을 비교하십시오. JWT를 비활성화하는 것은 해결 방법이 아닙니다. API에서 크기 제한이 표시되면 배포 환경에 구성된 제한과 파일을 비교하십시오. 파일 크기가 크거나 지원되지 않거나 손상된 소스 파일의 경우 다른 해결 방법이 필요할 수 있습니다. 브라우저나 네트워크를 변경해도 변환 제한이나 손상된 문서 문제는 해결되지 않습니다.

일반 로그에서 요청이 중단되는 위치를 확인할 수 없는 경우에만 디버그 로깅을 활성화하고, 필요한 증거를 수집한 후에는 다시 비활성화하십시오. 디버그 로그에는 민감한 요청 세부 정보가 포함될 수 있습니다. 설치 유형에 따른 ONLYOFFICE의 지침을 따르고, 문서 URL이나 토큰을 노출하는 대신 수정된 로그 발췌본을 관리자 또는 지원팀과 공유하십시오.

결과를 ​​확인하세요

• 다운로드한 파일이 존재하는지, 크기가 0이 아닌지, 그리고 PDF 리더에서 열리는지 확인하십시오.
• 원본과 첫 페이지와 마지막 페이지, 페이지 수, 그리고 몇 가지 주요 글꼴이나 이미지를 대조해 보세요.
• 관련 수정 후 내보내기를 한 번 더 반복하십시오. 그래도 실패하면 시간, ONLYOFFICE Docs 버전, 내보내기 단계, 그리고 오류 코드 또는 로그 발췌 내용을 기록해 두십시오.

ONLYOFFICE의 설명서는 PDF 다운로드 단계와 변환 오류를 구분합니다. 배포 환경에 맞는 자세한 내용은 문서 편집기 다운로드 및 인쇄 지침 , 공식 통합 문제 해결 가이드 , 변환 API 오류 코드 및 디버그 로깅 가이드를 참조하십시오.