ONLYOFFICE에서 PDF 내보내기 시 발생하는 "다운로드 실패" 오류 해결 방법

ONLYOFFICE에서 문서를 PDF로 내보낸 후 "다운로드 실패" 오류가 발생하는 경우, 먼저 PDF 생성, ONLYOFFICE에서 기기로의 전송 또는 브라우저에서의 최종 저장 중 어느 단계에서 오류가 발생했는지 확인하십시오. 성공적으로 내보내진 PDF 파일은 내용이 모두 포함되어 있어야 하며, 파일을 열었을 때 중요한 페이지 나누기, 표, 글꼴이 그대로 유지되어야 합니다. 아래 확인 사항들을 순서대로 시도해 보십시오. 각 단계는 원본 문서를 변경하지 않고 문제의 원인을 좁혀 나가는 데 도움이 됩니다.

먼저 사용 중인 ONLYOFFICE 버전을 확인하세요.

온라인 문서 편집기에서 문서를 다운로드하는 방법은 파일 > 다운로드 > PDF 입니다 . "다른 이름으로 저장"을 선택하면 컴퓨터로 다운로드하는 대신 포털에 사본이 저장됩니다. 데스크톱 편집기에서는 파일 > 다른 이름으로 저장을 선택하고 PDF를 선택하십시오. 앱과 버전에 따라 메뉴의 명칭과 옵션이 다를 수 있으므로 데스크톱 앱에 온라인 메뉴가 있다고 가정하지 마십시오. ONLYOFFICE의 문서 다운로드 및 인쇄 지침 과 파일 탭 가이드를 참조하십시오 .

기존 PDF 파일을 온라인 PDF 편집기에서 편집하는 경우, 다운로드 과정은 '파일' 메뉴 아래에 있지만, 다른 편집기에서 실행됩니다. 현재 사용 중인 앱의 안내를 따르세요.

1. 문제 해결 전에 편집 내용을 보호하세요.

내보내기를 다시 수행하기 전에 원본 문서를 저장하십시오. 온라인 편집기에서는 Ctrl+S를 누르거나, 가능하다면 파일 > 저장을 선택하고 저장 표시기가 안정될 때까지 기다리십시오. ONLYOFFICE는 온라인 편집기에서 문서를 자동으로 저장하지만, 세션을 새로 고치거나 닫기 전에 현재 변경 내용이 저장되었는지 확인해야 합니다. 데스크톱 편집기에서는 먼저 작업 파일을 일반적인 방법으로 저장하십시오.

그런 다음 문서 사본을 만들고 해당 사본에서 내보내기를 시도해 보세요. 이렇게 하면 원본을 손상시키지 않고 안전하게 테스트할 수 있습니다. 내보내기 요청이 진행 중인 동안 '내보내기' 버튼을 반복해서 클릭하지 마세요. 다운로드가 중복되면 어떤 파일이 성공적으로 완료되었는지 확인하기 어려울 수 있습니다.

2. 간단한 테스트 문서를 사용하여 오류의 원인을 파악하십시오.

한 페이지 분량의 짧은 텍스트가 포함된 새 문서를 만들고 동일한 앱과 기기를 사용하여 PDF로 내보냅니다. PDF 파일이 브라우저의 다운로드 목록이나 바탕 화면 저장 대화 상자에서 선택한 폴더에 나타나는지 확인하고 파일 크기가 0보다 큰지 확인합니다. PDF 뷰어에서 파일을 열고 텍스트가 제대로 보이는지 확인합니다.

• 테스트 PDF는 정상적으로 실행됩니다 . 내보내기 경로도 사용 가능합니다. 원본 파일에 변환 문제를 일으키는 콘텐츠나 서식이 포함되어 있거나, 다운로드 용량이 비정상적으로 크거나 다운로드 속도가 느릴 수 있습니다. 원본 파일의 사본을 사용하여 용량이 큰 이미지, 내장 개체 또는 복잡한 레이아웃을 한 번에 한 범주씩 일시적으로 단순화해 보세요.
• 테스트 PDF 파일이 온라인 편집기에서도 제대로 표시되지 않습니다. 브라우저 다운로드 상태를 확인하고 아래의 대체 방법을 시도해 보세요. 브라우저나 사용자에 관계없이 문제가 지속될 경우, 온라인 서비스 또는 서비스 통합에 문제가 있을 수 있습니다.
• 테스트용 PDF 파일은 데스크톱 편집기에서는 정상적으로 작동하지만 온라인에서는 작동하지 않습니다. 이 문제는 PDF 내보내기 자체의 문제라기보다는 브라우저, 온라인 세션, 포털 또는 문서 서버 연결과 관련된 문제일 가능성이 더 높습니다.

이 비교는 진단 단서일 뿐, 하나의 근본 원인을 입증하는 것은 아닙니다. 앱, 브라우저, 시간, 문서 크기, 그리고 오류가 특정 파일에만 영향을 미치는지 아니면 모든 파일에 영향을 미치는지 기록해 두세요.

3. PDF 생성과 브라우저 다운로드를 분리합니다.

온라인 편집기에서 파일 > 다운로드 > PDF를 한 번 선택한 다음 브라우저의 다운로드 패널을 확인하세요. 파일이 목록에 표시되면 브라우저의 "폴더에서 보기" 또는 유사한 기능을 사용하여 파일 크기를 확인합니다. 파일이 제대로 열리면 PDF 생성이 성공한 것이며, 나머지 문제는 브라우저가 파일을 저장한 위치 또는 다운로드를 처리한 방식과 관련이 있을 수 있습니다.

다운로드가 차단되거나, 중단되거나, 누락된 경우 브라우저의 다운로드 알림과 운영 체제의 사용 가능한 디스크 공간을 확인하세요. 브라우저 또는 기관에서 해당 사이트의 다운로드를 차단하는 경우 관리자에게 해당 사이트의 파일 다운로드 허용 여부를 문의하세요. 한 번만 테스트해 보려면 동일한 기기에서 다른 지원되는 브라우저를 사용하거나, 동일한 계정의 다른 기기를 사용해 보세요. 다른 기기에서 정상적으로 다운로드된다면 문서 자체를 변경하기보다는 첫 번째 브라우저의 다운로드 설정, 확장 프로그램, 보안 소프트웨어 또는 로컬 저장소에 문제가 있는지 확인하세요.

개인 정보 보호 모드를 사용하면 확장 프로그램이나 저장된 사이트 데이터가 문제의 원인인지 확인할 수 있지만, 로그인 후 동일한 문서를 열어볼 수 있는 경우에만 가능합니다. 서버 측 내보내기 오류를 해결하지는 못하며, 관리형 계정에는 적합하지 않을 수 있습니다. 첫 단계로 모든 브라우저 데이터를 삭제하지 마십시오. 관련 없는 서비스에서 로그아웃될 수 있습니다.

4. 다른 경로를 시도해보고 결과를 비교해 보세요.

온라인 문서 편집기에서 문서를 열려면 파일 > 다른 이름으로 사본 저장을 선택 하고 PDF 형식이 제공되는 경우 PDF를 선택하세요. 이렇게 하면 포털에 사본이 저장되지만, 브라우저에서 컴퓨터로 다운로드되는 경로는 확인하지 않습니다. 포털에 저장된 사본이 열리면 내보내기 과정에서 PDF 파일이 생성되었을 가능성이 높으며, 따라서 직접 다운로드 경로가 문제의 핵심일 수 있습니다.

임시 해결책으로 PDF로 인쇄해 볼 수도 있습니다. ONLYOFFICE 문서에는 인쇄 옵션이 나와 있으며, Firefox에서는 PDF를 먼저 다운로드하지 않고도 인쇄할 수 있다고 명시되어 있습니다. 브라우저나 운영체제에서 PDF 저장 위치를 ​​선택할 수 있는 경우, 인쇄 대화 상자에서 PDF 저장 위치를 ​​선택하세요. 데스크톱 편집기를 사용하는 경우, 인쇄 대화 상자에서 PDF 옵션을 사용할 수 있다면 해당 옵션을 사용하세요. 인쇄된 파일의 페이지 수, 페이지 나누기, 여백 근처의 내용 등을 원본과 비교해 보세요.

PDF로 인쇄하는 것은 내보내기와 동일하지 않습니다. 인쇄 레이아웃 설정이 적용될 수 있으며, 페이지 배율이 변경되거나 인쇄 영역 밖의 내용이 생략될 수 있습니다. 따라서 결과 파일이 직접 시각적으로 검토했을 때 만족스러운 경우에만 사용하십시오. 특히 양식, 스프레드시트 또는 정확한 페이지 매김이 필요한 문서의 경우에는 더욱 그렇습니다.

5. 데스크톱 편집기를 사용하는 경우, 간단한 로컬 경로에 저장하십시오.

데스크톱 편집기에서 파일 > 다른 이름으로 저장을 선택하고 PDF를 선택한 다음, 문서 폴더와 같이 쓰기 권한이 있는 폴더에 사본을 저장하세요. 일반 문자와 숫자를 사용하여 짧은 파일 이름을 지정하십시오. 처음 테스트할 때는 네트워크 공유, 동기화 폴더, 이동식 드라이브 또는 보호된 시스템 디렉터리에 직접 저장하지 마세요. 로컬 사본이 제대로 저장되면 나중에 원하는 위치에 다시 저장해 보세요. 이렇게 하면 저장 위치 또는 권한 문제일 가능성이 높아집니다.

저장 대화 상자가 완료되었지만 사용 가능한 PDF 파일이 생성되지 않으면 폴더에 쓰기 권한이 있고 여유 공간이 있는지 확인하십시오. 대상 파일이 잠겨 있을 수 있는 PDF 뷰어를 닫고 새 파일 이름을 지정한 후 다시 시도하십시오. 기본 테스트는 성공했지만 원본 문서 중 하나만 실패하는 경우, 작업용 사본을 만들고 크기가 비정상적으로 크거나 손상된 저장 매체를 제거하거나 교체한 후 테스트하십시오. 사본을 확인하기 전까지 원본은 변경하지 마십시오.

6. 관리자가 서버를 점검해야 하는 경우

온라인 편집기에서 모든 사용자가 오류를 경험하거나 직접 다운로드 및 포털 복사 모두 실패하는 경우, ONLYOFFICE 관리자에게 시도 시간, 영향을 받는 문서의 대략적인 크기, 브라우저 및 버전, 그리고 작은 테스트 문서에서도 오류가 발생하는지 여부를 알려주십시오. 통합 또는 자체 호스팅 설치의 경우, 관리자는 해당 시간대의 문서 서버 및 플랫폼 로그를 확인하고, 편집기와 스토리지 플랫폼 간의 연결 상태를 확인하고, 최근 프록시 또는 네트워크 변경 사항을 검토해야 합니다.

ONLYOFFICE의 문제 해결 참조에서는 특정 편집기 오류를 보안 토큰 만료, 세션 끊김 또는 저장 오류와 연관시키며, 관리자에게 저장 실패의 경우 DocService 로그와 콜백 연결 가능성을 확인하도록 권장합니다. 이러한 메시지는 관련 진단 정보일 뿐, 모든 "다운로드 실패" 알림에 대한 보편적인 설명은 아닙니다. 인스턴스가 리버스 프록시 뒤에 있는 경우, 현재 ONLYOFFICE 프록시 구성 가이드에 따라 전달된 호스트 및 프로토콜 헤더를 확인하십시오 . 관리자는 ONLYOFFICE의 디버그 로깅 지침에 따라 더 자세한 정보를 수집한 후 진단 후 로깅 수준을 정상으로 되돌릴 수 있습니다.

JWT 비밀 키를 변경하거나, 인증을 비활성화하거나, 테스트 목적으로 문서 서버를 공개적으로 노출하지 마십시오. 이러한 변경은 보안 및 통합 문제를 야기할 뿐만 아니라 내보내기 오류를 해결하지 못할 수 있습니다.

문제가 해결되었는지 확인하는 방법

먼저 작은 테스트 문서를 내보낸 다음, 원본 작업용 문서를 내보냅니다. 각 PDF 파일의 크기가 0이 아닌지, 오류 없이 열리는지, 예상 페이지 수를 포함하는지, 그리고 중요한 텍스트, 표, 이미지 및 페이지 나누기가 제대로 유지되는지 확인합니다. "다른 이름으로 저장" 또는 "PDF로 인쇄" 기능을 사용한 경우, 파일이 의도한 포털 또는 로컬 폴더에 있는지 확인하고 정상적으로 내보낸 파일과 레이아웃을 비교합니다. 한 가지 방법만 작동하는 경우, 해당 차이점을 관리자에게 보고하십시오. 이는 추가 조사가 필요한 단계를 나타냅니다.

공식 참고 자료

• ONLYOFFICE: 문서 저장, 다운로드 및 인쇄
• ONLYOFFICE: 문서 편집기 파일 탭
• ONLYOFFICE Docs 문제 해결 참조
• 프록시 서버 뒤에서 OnlyOffice 문서를 열 수 있습니다.
• ONLYOFFICE Docs 디버그 로깅