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、JavaScript 等语言的 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 里复制出来带 \/ 转义的字符串，或者整段接口响应都行。字符串特别长时，用「打开 .txt 文件」比粘贴更快。

2. 2

   看一眼「读取方式」

   输入框下方会列出每一步清理：去掉了前缀、还原了转义、补了填充、从 JSON 的哪个字段取的值。输入有问题时，报错会指出具体是哪个字符、在第几位。

3. 3

   核对文件类型和提示

   徽标显示的是按文件头（魔数）识别出的真实类型。不是 PDF、data URI 声明的类型与内容不符、PDF 末尾缺 %%EOF（被截断）时，都会出现黄色提示并说明原因。

4. 4

   预览并下载

   PDF 用浏览器自带的阅读器内嵌显示，图片和文本直接显示。需要的话改一下文件名，点「下载」即可。要把文件转成 Base64，切到「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

接口把 PDF 以 Base64 返回

电子发票、电子签章、快递面单这类接口常把文件放在 JSON 里返回。先把响应粘到这里看看文件对不对，再去写保存文件的代码。

排查 Base64 转 PDF 后打不开

代码保存出来的 PDF 空白或报损坏时，把同一段 Base64 粘到这里：是被截断、被编码了两次、根本不是 PDF，还是完全正常——正常就说明问题出在你写文件的那段代码。

在 JSON 请求里上传文件

很多上传接口要求 {"filename": …, "content": "<base64>"} 这种格式。在这里把文件转成 Base64，拼成 Postman 或 cURL 的测试请求。

把文件嵌进 HTML、CSS 或邮件

生成 data URI，用于内嵌的 PDF 链接、字体或小图片；或者生成每 76 字符换行的 Base64，放进 MIME 邮件正文。

从日志和数据库里取回附件

存在文本列里、打印在日志里的文件可以直接还原出来——如果提示缺 %%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 都不可能出现——说明复制时丢了或多了一个字符。= 出现在中间，通常是两段 Base64 被拼在了一起。

文件类型由魔数决定

文件在开头几个字节里声明自己的格式：PDF 是 %PDF-，PNG 是 89 50 4E 47，DOCX、XLSX 这类基于 ZIP 的格式是 50 4B 03 04。这些字节决定了 Base64 的前几个字符，所以不解码也能看出类型——见工具里的对照表。

怎样判断 PDF 被截断

PDF 以 %%EOF 结尾。如果最后 1,024 个字节里找不到它，文件几乎可以肯定被截短了。PDF 头允许出现在前 1,024 个字节内的任意位置，大多数阅读器仍能打开这种文件，所以这里只提示、不拒绝。

用 Base64 传文件的建议

文件名和 MIME 类型随数据一起传

Base64 本身不带文件名和类型。把它们放在旁边（{"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}），或者直接用 data URI，接收方就不必去猜。

接收端先校验魔数

保存之前检查解码结果是否以 %PDF- 开头。一行代码就能拦住取错字段、重复编码、把错误页面当文件编码这几类问题。

大文件改用 multipart 或下载链接

Base64 让体积多出三分之一，而且整串都要放在内存里。文件超过几 MB 时，multipart/form-data 或预签名下载链接对两端都更轻。

数据库里存字节，不存 Base64

BLOB/bytea 列比 Base64 文本小三分之一，也不会像 VARCHAR 那样被静默截断。只在接口边界上做 Base64 编码。

Base64 转 PDF 常见问题