PDF 转图片失败：密码错误会整份阻断，单页异常可以隔离

PDF 转图片失败时，先判断故障发生在哪一层：密码错误发生在打开文档之前，会阻断整份 PDF；某一页尺寸过大或渲染异常发生在逐页处理阶段，可以记录失败页，让其他页面继续。

把这两类问题混在一起，常见结果是反复输入密码、反复转换整份文件，却没有定位真正失败的页。更有效的做法是先证明文档能打开，再缩小页码范围，单独处理异常页。

图注：页码、密码和失败页应分开处理。

密码错误是文档级硬阻断

加密 PDF 必须先用正确密码完成加载，页面列表和缩略图才有机会生成。未填写密码或密码错误时，图叮 PDF 转图片会提示“PDF 需要正确密码才能打开”，此时不存在“先转没有加密的几页”这一条路径，因为工具还没有获得整份文档的页结构。

这里输入的是打开 PDF 所需的密码。即使文件能在某个阅读器中自动打开，也可能是该设备已经缓存了凭据，不代表 PDF 没有密码。可以在无缓存的阅读器中重新打开验证，或向文件提供方确认密码。

不要把密码写进文件名、聊天截图或长期保存的转换记录。完成临时转换后，应清理不再需要的副本；如果文件包含敏感内容，还要先确认使用场景是否允许在当前设备中处理。

页码范围只在文档打开后生效

文档成功加载后，才进入页面选择。页码范围可以写成 1,3-5，表示转换第 1、3、4、5 页。页码不存在、范围倒置或格式不合法时，应先修正选择，而不是重新上传文件。

图叮工具单次最多选择 200 页，上传文件上限为 100 MB。长文档不必每次从第一页转到末页，可以先用小范围做探测：

1. 先转第 1 页，确认密码、解析和基础导出链路可用；
2. 再按章节或每 20 页分段；
3. 某一段出现错误时，把范围继续二分，直到定位到具体页。

这个方法比逐页盲试更快，也能保留已成功页面。

单页失败不会自动否定其他页面

工具会对每个选中页面分别做预检和渲染。某一页画布过大、渲染失败或超出单页安全边界时，该页会记录错误，其他通过预检的页面仍可继续处理。

因此，结果页应当按页码建立一份简单台账：

• 成功：记录页码、导出格式和输出尺寸；
• 失败：记录页码与页面返回的原因；
• 待复核：图片已生成，但文字、透明区域或方向需要人工检查。

这份台账能回答“缺的是哪一页”，避免把 99 个成功结果和 1 个失败结果一起丢弃。异常页可以回到原 PDF 单独导出，或让文件提供方重新生成该页。

还有一种批次级失败：总内存超过边界

单页隔离并不意味着任何数量都能在一次批次里完成。页面转图片后会形成 RGBA 像素数据，选中页面的预估总量超过 256 MiB 时，整批会在渲染前停止。这个门槛与 PDF 文件压缩后的 MB 大小不是同一个概念：文件很小，页面尺寸和放大倍数很高，解码后的像素仍可能很大。

遇到批次级内存提示，应缩小页码范围或降低放大倍数，而不是不停刷新。若某一页本身尺寸异常，再把它从正常批次中移出，单独评估是否需要更低倍率。

一套可复验的恢复流程

在PDF 转图片工具中按下面顺序操作：

1. 上传 PDF；若页面要求密码，先验证密码正确，直到页数能够读取。
2. 输入一个很小的合法页码范围，先确认至少一页能成功生成。
3. 分段扩大范围；每次保留成功文件，不覆盖前一批结果。
4. 出现单页错误时，记录页码并从下一批排除，不让它阻断正常页面的交付。
5. 出现总内存提示时，减少页数或放大倍数，再重试该批。
6. 最后按原 PDF 页码核对文件是否齐全，重点检查失败页前后是否出现编号错位。

验收不能只看“下载了一个压缩包”。应确认密码没有被错误记录、成功页数量与台账一致、失败页有明确去向、图片文字在目标尺寸下可读。这样即使 PDF 不能一次全部转换，也能先交付确定可用的页面，而不是把一个局部问题放大成整份失败。