Base64 PDF·파일 변환 (PDF → Base64 변환도 지원)

Base64 PDF 변환 — 빠른 답변

Base64 PDF란 무엇인가요?

%PDF-1.4          → bytes 25 50 44 46 2D 31 2E 34
JVBERi0xLjQ=      → the same bytes in Base64
data:application/pdf;base64,JVBERi0xLjQ=   → data URI form

주요 기능

Python, Java, 자바스크립트 등에서 Base64를 PDF로 변환

Base64 PDF 변환 예시

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4K…

PDF · 버전 1.4 · file.pdf로 저장

"data:application\/pdf;base64,JVBERi0xLjQK…"

전처리: 앞뒤 따옴표 제거 → JSON 이스케이프 복원 → data URI 접두사 제거(application/pdf)

{"code":0,"data":{"name":"invoice.pdf","file":"JVBERi0xLjQK…"}}

전처리: JSON에서 data.file 필드를 꺼냄

data:application/pdf;base64,iVBORw0KGgoAAAANSUhEUgAA…

경고: data URI에는 application/pdf라고 되어 있지만 실제 바이트는 PNG입니다. file.png로 저장했습니다

255044462d312e370a…

경고: 16진수로 보입니다. 16진수로 읽으면 PDF입니다. [16진수로 디코딩]

Base64를 PDF로 변환하는 방법

1. 1

   받은 Base64를 그대로 붙여넣기

   순수 Base64, data:application/pdf;base64,…, JSON에서 복사해 \/ 이스케이프가 섞인 문자열, API 응답 전체 모두 됩니다. 아주 긴 문자열은 붙여넣기보다 .txt 파일 열기를 사용하세요.

2. 2

   어떻게 읽었는지 확인

   입력란 아래에 접두사 제거, 이스케이프 복원, 패딩 추가, JSON에서 꺼낸 필드 등 수행한 전처리가 모두 나열됩니다. 입력에 문제가 있으면 오류 메시지가 해당 문자와 위치를 정확히 알려 줍니다.

3. 3

   판별된 형식과 경고 확인

   배지에는 파일의 매직 바이트로 읽은 형식이 표시됩니다. 실제로는 PDF가 아닐 때, data URI가 형식을 잘못 표시할 때, PDF가 %%EOF 앞에서 잘렸을 때 노란색 안내가 나타납니다.

4. 4

   미리보기 후 다운로드

   PDF는 브라우저 내장 뷰어로 열리고, 이미지와 텍스트는 바로 표시됩니다. 필요하면 파일 이름을 바꾼 뒤 다운로드를 누르세요. 반대 방향은 PDF / 파일 → Base64로 전환해 파일을 끌어다 놓으면 됩니다.

Base64로 변환한 PDF가 열리지 않을 때: 흔한 실수

base64.b64decode(value)  # value = 'data:application/pdf;base64,JVBERi0…'

b64 = value.split(',', 1)[1] if value.startswith('data:') else value
pdf = base64.b64decode(b64)

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64').toString())

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64'))

byte[] pdf = Base64.getDecoder().decode(wrapped);  // IllegalArgumentException

byte[] pdf = Base64.getMimeDecoder().decode(wrapped);

base64.b64decode(token_part)  # contains - and _

base64.urlsafe_b64decode(token_part + '=' * (-len(token_part) % 4))

new Blob([atob(b64)], { type: 'application/pdf' })

const bytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0));
new Blob([bytes], { type: 'application/pdf' })

SELECT LENGTH(pdf_b64) FROM docs;  -- 65535: suspiciously round

ALTER TABLE docs MODIFY pdf_b64 LONGTEXT;  -- or store the bytes in a BLOB

Base64 PDF 변환이 필요한 경우

API가 PDF를 Base64로 반환할 때

전자 세금계산서, 전자 서명, 송장 출력 API는 문서를 JSON에 담아 돌려주는 경우가 많습니다. 저장 코드를 작성하기 전에 응답을 붙여넣어 문서 내용부터 확인할 수 있습니다.

열리지 않는 PDF 디버깅

저장한 파일이 빈 화면이거나 손상되었다고 나오면 같은 Base64를 여기에 붙여넣으세요. 잘렸는지, 이중 인코딩되었는지, 아예 PDF가 아닌지, 아니면 정상인지 알려 줍니다. 정상이라면 버그는 파일을 쓰는 코드 쪽에 있습니다.

JSON 요청으로 파일 전송

많은 업로드 API가 {"filename": …, "content": "<base64>"} 형식을 요구합니다. 여기서 파일을 인코딩해 Postman이나 cURL용 테스트 요청을 구성할 수 있습니다.

HTML·CSS·이메일에 파일 삽입

인라인 PDF 링크, 글꼴, 작은 이미지에 쓸 data URI를 생성하거나, MIME 이메일 파트에 넣을 76열 Base64를 생성합니다.

로그와 데이터베이스에서 첨부 파일 복원

텍스트 열에 저장되었거나 로그에 출력된 파일을 바로 되살릴 수 있습니다. %%EOF가 없다는 안내가 나오면 열이나 로그 줄이 너무 짧아 잘렸다는 뜻입니다.

Base64 파일 인코딩의 원리

Base64가 33% 커지는 이유

한 문자는 6비트를 담으므로 3바이트(24비트)에는 4문자가 필요합니다. 패딩을 포함한 길이는 4 × ⌈n ÷ 3⌉이며, 100 KB(102,400바이트)는 136,536문자가 됩니다. MIME 형식은 76문자마다 CRLF를 넣으므로 1 MB는 1,398,104문자가 아니라 1,434,896문자가 됩니다.

표준 알파벳과 URL 안전 알파벳

RFC 4648은 마지막 두 문자만 다른 두 가지 알파벳을 정의합니다. + /(표준, 4절)와 - _(URL·파일 이름 안전, 5절)입니다. URL 안전 Base64는 보통 = 패딩을 생략합니다. 한 문자열에 두 가지가 섞여 있다면 편집되었거나 이어 붙인 것입니다.

패딩과 불가능한 길이

= 패딩은 길이를 4의 배수로 맞춥니다. 패딩이 없을 때 4로 나눈 나머지가 2나 3이면 복원할 수 있지만, 나머지 1은 올바른 Base64에서는 나올 수 없습니다. 문자가 하나 빠졌거나 더해진 것입니다. 중간에 =가 있으면 대개 두 문자열이 이어 붙은 것입니다.

형식은 매직 바이트가 결정

파일은 첫 바이트로 자신의 형식을 나타냅니다. PDF는 %PDF-, PNG는 89 50 4E 47, DOCX와 XLSX 같은 ZIP 기반 형식은 50 4B 03 04입니다. 이 바이트가 Base64의 첫 문자들을 결정하므로 디코딩 전에도 형식을 알 수 있습니다. 도구 안의 표를 참고하세요.

잘린 PDF를 감지하는 방법

PDF는 %%EOF로 끝납니다. 마지막 1,024바이트 안에 이것이 없으면 파일은 거의 확실히 잘린 것입니다. 헤더는 앞쪽 1,024바이트 안 어디에서 시작해도 되고 대부분의 뷰어가 이런 파일도 열기 때문에, 알려 주기만 하고 거부하지는 않습니다.

Base64로 파일을 보낼 때의 모범 사례

MIME 타입과 파일 이름을 데이터와 함께 전송

Base64 자체에는 이름도 형식도 없습니다. 둘 다 옆에 함께 두거나({"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}) data URI를 쓰면 받는 쪽이 추측할 필요가 없습니다.

받는 쪽에서 매직 바이트 확인

저장하기 전에 디코딩한 바이트가 %PDF-로 시작하는지 검증하세요. 잘못된 필드, 이중 인코딩, Base64로 반환된 오류 페이지를 코드 한 줄로 걸러 낼 수 있습니다.

큰 파일은 multipart나 URL로

Base64는 크기를 3분의 1 늘리고 문자열 전체를 메모리에 올려야 합니다. 몇 MB를 넘으면 multipart/form-data나 미리 서명된 다운로드 URL이 양쪽 모두에 더 가볍습니다.

데이터베이스에는 Base64가 아닌 바이트로 저장

BLOB/bytea 열은 3분의 1 더 작고, VARCHAR처럼 소리 없이 잘리지도 않습니다. Base64 인코딩은 API 경계에서만 하세요.

Base64 PDF 변환 — 자주 묻는 질문