PDF 转 Base64

通过 JSON 接口发送 PDF

JSON 没有二进制类型，所以接收文档的 REST 接口通常要求以 Base64 字符串提交。电子签名平台、开票和电子发票系统、打印邮寄服务、OCR 引擎以及文档归档系统都常用这种方式接收 PDF，字段名一般是 content、file 或 documentBase64，文件名放在另一个字段中。有些服务也用同样的方式返回 PDF，可以用 Base64 转 PDF 还原为文件。

除非接口文档另有说明，请提交不换行的纯 Base64，很多接口会拒绝仍带有 data:application/pdf;base64, 前缀的值。还要留意请求大小限制：7.5 MB 的 PDF 编码后约为 10 MB。

如何认出 Base64 格式的 PDF

PDF 文件以字符 %PDF- 加版本号开头，这几个字节编码为 Base64 后，总是以 JVBERi0 开头。如果在接口响应、数据库字段或日志文件中看到以 JVBER 开头的长字符串，基本可以确定它是 PDF。发送请求前也可以这样快速检查：如果字符串的开头不是这几个字符，可能编码了错误的数据，或者重复编码了两次。

在 HTML 中嵌入 PDF

借助 Data URI，可以把整个 PDF 放进 HTML 页面，无需另外托管文件：

<embed src="data:application/pdf;base64,JVBERi0..." type="application/pdf" width="100%" height="600">

<iframe src="data:application/pdf;base64,JVBERi0..." width="100%" height="600"></iframe>

这种方式适用于带有内置 PDF 查看器的桌面浏览器，但也有局限。很多移动浏览器根本不会在页面内显示 PDF。Chrome 等浏览器还会阻止网页把整个标签页跳转到 data: 网址，所以指向 data:application/pdf 的链接或 window.open 调用可能只会打开空白页，甚至毫无反应。如果要用 JavaScript 在新标签页中打开 PDF，请先把 Base64 转成 Blob URL。超过几 MB 的文档，通常还是使用普通的文件链接更合适。

在代码中编码 PDF

# Python：构造 JSON 请求体
import base64, json
from pathlib import Path

pdf_b64 = base64.b64encode(Path('invoice.pdf').read_bytes()).decode('ascii')
body = json.dumps({'filename': 'invoice.pdf', 'content': pdf_b64})

// 浏览器：file 来自 <input type="file">
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // 去掉 Data URI 前缀
};
reader.readAsDataURL(file);