跳到主要内容
PPDF123

修复损坏的 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?

  1. 上传一份本地 qpdf 或许仍能打开的 PDF。
  2. 点击处理。没有修复档位。
  3. 下载重写后的 PDF。
  4. 打开看看。若 qpdf 失败,磁盘上的原件还在。
  5. 要翻到结果的最后一页,而不只是第一页。损坏最常出现在文件末尾附近,在第 1 页能打开的重写文件,仍可能缺了尾部。
  6. 如果页数比你预期的少,请先停下,重新下载或重新导出源文件,不要相信被缩短的副本。

限制与边界

  • 没有深度对象重建
  • 重写成功并不保证每一页都能渲染;请检查输出
  • 文件里缺失的图片或字体数据无法重新生成
  • 不返回修复了什么的日志,只返回新文件
  • 不是删除密码
  • 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

全部 Agent Skill

文件只用于本次处理,完成后自动删除。