How-to약 2분

파일이 열리지 않을 때: Get Info로 점검하고 Repair로 고친 뒤 추측을 멈추기

PDF가 열리지 않으면 먼저 Get Info로 사전 점검하고, Repair로 구조를 다시 세웁니다. 이는 xref 복구이며 데스크톱 Recovery Toolbox를 흉내 낸 도구가 아닙니다.

By the PDF123 team · Updated 2026-10-04
파일이 열리지 않을 때: Get Info로 점검하고 Repair로 고친 뒤 추측을 멈추기

열리지 않는 PDF는 보통 구조 문제입니다. 교차 참조 테이블이 깨졌거나, 다운로드가 잘렸거나, 객체가 망가진 경우입니다. 손으로 다시 그릴 수 있는 페이지 이미지가 빠진 것이 아닙니다. 파일이 파싱되기도 전에 OCR이나 압축, 변환으로 추측하면 시간만 버립니다.

먼저 Get Info

문서 정보(POST /api/v1/security/get-info-on-pdf)는 JSON 보고서를 돌려줍니다. FileSize, PageCount, Encrypted, 있을 때만 나오는 Info 딕셔너리 필드(title, author, subject, creator, producer), PDF Version, 단순한 Pages 목록, 그리고 문서 루트를 찾았는지 여부입니다. 사전 점검으로 쓰세요.

  • Encrypted: true라면 대부분의 편집 전에 권한 있는 비밀번호 해제가 필요합니다. 복구만으로 비밀번호가 풀리지는 않습니다.
  • PageCount / FileSize가 멀쩡해 보이는데 데스크톱 뷰어가 여전히 실패한다면, 다음은 구조적 PDF 복구입니다.
  • 호출 자체가 바이트를 읽지 못한다면 깨끗한 Info 한 번을 통과하기 어려울 만큼 손상된 것입니다. 그래도 사본에 복구를 시도해 보세요.

Get Info는 PDF를 다시 쓰지 않습니다. 파서가 무엇을 볼 수 있는지 알려 줄 뿐입니다. 모든 실패를 "OCR이 필요하다"거나 "압축이 필요하다"로 처리하지 않게 하기 위해서입니다.

그다음 Repair( qpdf를 통한 구조 재구성 )

PDF 복구(POST /api/v1/misc/repair)는 qpdf로 파일을 다시 써서, 남은 객체가 충분하면 뷰어가 다시 열 수 있게 합니다. 성공하면 원래 보여 주려던 페이지 내용은 보존됩니다. 이 작업이 고치는 것은 파일의 지도(xref / 객체 스트림)이며, 삭제된 초안을 포렌식으로 되살리는 것이 아닙니다.

복구는 다음이 아닙니다.

  • OCR이나 스캔 정리(파일은 열리는데 텍스트가 이미지뿐인 경우): OCR을 쓰세요. 여기서는 검색 가능한 PDF 레이어가 아니라 Markdown 텍스트를 돌려줍니다.
  • 비밀번호 제거: 비밀번호 해제를 쓰세요.
  • 글꼴 수리나 "파일을 다시 편집 가능하게 만들기"
  • Windows 제품 "Recovery Toolbox for PDF"의 복제품

브랜드와 채널의 구분(온라인 구조 복구 대 데스크톱 "recovery toolbox" 검색)은 PDF 온라인 복구와 Recovery Toolbox 검색에서 다룹니다.

추측을 멈추는 결정 트리

  1. 뷰어가 파일을 열지 못합니다: 문서 정보, 그다음 PDF 복구.
  2. 파일은 열리는데 스캔에서 선택과 검색이 안 됩니다: OCR로 Markdown 텍스트를 얻고, 크기가 남은 문제라면 사본을 PDF 압축합니다(스캔 묶음: OCR 후 압축).
  3. 파일은 열리는데 표가 204로 내보내집니다: 열이 감지되지 않은 것입니다. 빈 표 내보내기(204)를 보세요.
  4. 스크립트나 에이전트에서 같은 복구를 하려면: 개발자를 통해 POST /api/v1/misc/repair를 호출합니다. 클라이언트가 업로드를 재시도한다면 Idempotency-Key를 보내세요(Idempotency-Key).

"복구됨"이 여전히 고치지 못하는 것

복구에 성공했다는 것은 뷰어가 파일을 다시 열 수 있다는 뜻입니다. 다음을 뜻하지는 않습니다.

  • 모든 페이지 이미지가 없던 곳에서 재구성됐다(빠진 객체는 계속 빠져 있습니다)
  • 스캔에서 텍스트를 선택할 수 있게 됐다(여기서는 OCR이 Markdown을 만듭니다)
  • 암호화가 사라졌다(아는 비밀번호로 해제해야 합니다)
  • 표가 내보내진다(여전히 열 형태의 텍스트가 필요하고, 204는 하나도 감지되지 않았다는 뜻입니다)

복구 후 Get Info가 멀쩡한 페이지 수를 보여 주는데 어떤 페이지가 비어 있다면, 구조는 되살아났지만 그 페이지 내용이 원본 바이트에서 이미 비었거나 잘렸을 수 있습니다.

손상된 원본은 남겨 두기

복구된 파생본 옆에는 손상된 원본을 남겨 두세요. 복구가 구조를 충분히 되살리지 못한다면, 정직한 결론은 "바이트가 사라졌다"이지 카탈로그에서 다른 도구를 무작위로 골라 시도하는 것이 아닙니다. 아직 파싱되지 않는 파일을 압축하거나 변환해도 빠진 객체가 생겨나지는 않습니다.

이 도구를 데스크톱 "recovery toolbox" 브랜드 검색으로 찾았다면, 채널 의도 비교는 PDF 온라인 복구와 Recovery Toolbox 검색에서 보세요. 카탈로그 도구의 브라우저 경로에는 계정이 필요하지 않습니다.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool