修复损坏的 PDF
修复 PDF 用 qpdf 重写受损的 PDF,重建其交叉引用表,让文件重新能打开。它能救回 qpdf 仍能读取的部分;无法找回缺失的图片或已被破坏的数据。
把文件拖到这里,或点击选择
支持 PDF · 单个文件不超过 500.0 MB · 一次最多 20 个文件
也可以按 Ctrl/Cmd+V 或从剪贴板菜单粘贴文件。
修复 PDF 重新读取文件,并用 qpdf 重写(`qpdf input -- output`)。这次重写会重建 xref,并能救回 qpdf 仍能解析的文件。它不是烧坏的流、缺失图片或 DRM 的取证重建器。
没有选项。qpdf 读不了就失败。有密码保护的文件,在你输入密码后会在本页为你解锁(API 调用方需先运行移除密码)。修复 PDF 不是猜密码。
已经能打开的文件回来时对象层可能略有不同,屏幕上看着一样。
若只要更小的流,压缩 PDF 才是明确的打包工具。若注释必须变成页面内容,用展平 PDF。
实际要问的是文件到底能不能打开。如果阅读器显示一片空白、提示“文件已损坏”,或者读到一半就停了,通常的嫌疑对象是交叉引用表(告诉阅读器每个对象在文件中位置的索引),而重写这份索引正是 qpdf 所做的事。如果文件能打开但看着不对,比如缺字体或文字乱码,问题出在内容本身,结构性的重写改变不了它。
结果是一个新文件,以你上传的文件名加 `.pdf` 扩展名命名。你的原文件绝不会被修改,所以随时可以拿两份对比。重写成功只能证明 qpdf 能够解析并写出这份文档,并不保证每一页都能渲染,所以在删除原文件之前,请先打开结果逐页翻看。
功能
- qpdf 重写,不加额外标志
- 能修 qpdf 仍能解析的部分 xref/结构问题
- 不是内容重建器
- 匿名 API:/api/v1/misc/repair
适用场景
- 给别的工具写得很乱的导出重建 xref
- 在放弃一份轻微损坏的文件前先试 qpdf
- 合并 PDF 前先把结构弄顺
- 抢救被邮件网关或文件同步客户端改坏的 PDF,其中只有索引受损
- 为一份在浏览器里能打开、却被更严格的桌面阅读器拒绝的文件生成干净的副本
- 在向发件人再要一份新文件之前,先对来自旧的或少见的生成器的导出文件重试一次
如何修复损坏的 PDF?
- 上传一份本地 qpdf 或许仍能打开的 PDF。
- 点击处理。没有修复档位。
- 下载重写后的 PDF。
- 打开看看。若 qpdf 失败,磁盘上的原件还在。
- 要翻到结果的最后一页,而不只是第一页。损坏最常出现在文件末尾附近,在第 1 页能打开的重写文件,仍可能缺了尾部。
- 如果页数比你预期的少,请先停下,重新下载或重新导出源文件,不要相信被缩短的副本。
限制与边界
- 没有深度对象重建
- 重写成功并不保证每一页都能渲染;请检查输出
- 文件里缺失的图片或字体数据无法重新生成
- 不返回修复了什么的日志,只返回新文件
- 不是删除密码
- qpdf 读不了就失败
- 本网站的上传上限:每个文件 500 MB,超过约 95 MB 时分块上传。直接调用 API 时,单个请求体上限为 100 MB。
示例
- xref 很乱但 qpdf 仍能读的 PDF,修复后常常能打开
- 流写到一半被截断的文件通常报错
- 一份 40 页的导出文件,索引指向了错误的字节偏移:阅读器提示损坏,修复 PDF 返回能正常打开的 40 页文件
- 下载到 60% 就中断:修复 PDF 要么直接失败,要么返回一份更短的文件,正确的下一步是重新下载
- 一份有一页图像无法读取的扫描文件:结构也许能修好,但那一页仍会显示为空白或损坏
本工具的隐私说明
文件经 HTTPS 上传,在服务器内存或短期临时目录中处理,结果就绪后即删除。我们不会为日后浏览、训练或广告画像保留副本。留存期限与 AdSense Cookie 说明见隐私政策。
常见问题
- 我的 PDF 在浏览器里能打开,在 Acrobat 里不行。该运行修复吗?
- 该,这正合适。对于损坏的索引,浏览器往往比桌面阅读器更宽容,而 qpdf 重写会把结构规范化,让更严格的阅读器也能接受。如果重写之后仍然打不开,说明损坏在内容流里面。
- 失败是什么样子?
- 任务会返回错误,而不是文件。这表示 qpdf 没能把文档解析到可以写出的程度。请试试重新下载原文件、从源应用程序重新导出,或者在创建它的程序里打开并另存一份新的。
- 文件大小会变吗?
- 因为对象被重新写出,大小可能略增或略减。修复 PDF 不会重新压缩图片,所以别指望大幅缩小。以缩小为目标时请用压缩 PDF。
- 能对本来就正常的文件运行修复吗?
- 可以,你会得到一份结构整洁的副本。可见页面应该没有任何差别。如果某个输入文件在合并或拆分里引发过错误,先做这一步规范化是合理的。
- 修复 PDF 能找回被截掉的页吗?
- 不能。数据在文件里已经缺失的页仍然缺失。修复 PDF 只能重写还读得出来的内容。
- 能恢复下到一半的文件吗?
- 只有 qpdf 仍能解析时才有机会。很多截断文件会直接失败。
- 修复 PDF 会解密吗?
- 只对不需要密码就能打开的文件(仅有所有者密码限制):这类文件返回时不再加密。需要密码才能打开的文件会被拒绝;请用你有权使用的密码去移除密码。
- 这和压缩 PDF 一样吗?
- 不一样。修复 PDF 是裸的 qpdf 重写。压缩 PDF 会加流和对象流标志。
- 文字会变吗?
- 不会去改词。对象号和偏移通常会变。
最后更新:
用代码调用
本站每个工具都是普通 REST 接口。匿名使用不需要账号或 API Key,给浏览器、开发者和智能体同样可用。
curl -X POST "https://pdf123.xyz/api/v1/misc/repair" \
-F "[email protected]" \
-o output.pdf也提供 MCP 工具,供说 Model Context Protocol 的客户端调用(JSON-RPC 2.0,POST /mcp)。 完整 API 文档
在 AI 代理中使用
Skill装上这个 Skill,Claude Code、Codex、Cursor 等 AI 代理就能替你完成「修复 PDF」: /skills/pdf123-repair.md
文件只用于本次处理,完成后自动删除。