EPUB能打开却缺图片：从原文件、阅读器和资源路径排查

故障分类与安全排查前提

在开始排查前，必须先理清缺图的具体表现形式。常见情况主要分为三种：

1. 仅缺失封面：书架或封面页空白，但内文配图齐全。可检查封面图片是否存在，以及对应 EPUB 版本的封面声明是否正确；阅读器提取封面的方式也可能不同。
2. 全书所有图片均不显示：页面仅留文字或空白占位框。多为图片根目录相对层级错误、阅读引擎阻断外部资源，或所用图片格式不被阅读器支持。
3. 个别章节或部分插图缺失：文字流正常，仅某几幅图显示为裂图图标。多见于单张图片相对路径拼写错误、文件名大小写不匹配，或该文件未在清单中注册。

安全前提： 严禁直接在唯一的原稿或下载文件上进行任何解包或修改操作。排查的第一步必须是将原文件完整复制一份（例如重命名为 book-test-copy.epub），所有测试与检查均在副本上进行。

跨阅读器交叉验证：定位问题边界

判断故障来自阅读器还是电子书文件本身，最直接的方法是使用另一款符合规范的阅读环境进行对照。

读者可参考 EPUB阅读入门指南 选用遵循标准的通用阅读工具（如 Calibre、Thorium Reader 或系统自带图书应用）打开同一测试副本：

• 若在备用阅读器中图片正常显示：提示问题可能与原阅读器兼容性或设置有关，但不证明文件内部结构完全正确。此时可尝试清理该阅读器的本地图书缓存、重置排版显示设置，或更新软件版本。部分阅读器在特定分页与夜间模式渲染下可能会屏蔽非文字元素，有关视图适配可参考 EPUB分页机制说明 进行基础排查。
• 若在多个阅读器中均缺失相同图片：应优先检查文件资源及引用；多个阅读器也可能有共同的格式限制，因此这仍是排查线索而非最终结论。

EPUB 内部机制与资源路径排查（面向无DRM文件）

根据 W3C EPUB 3.3 规范，EPUB 本质上是遵循特定目录结构的 ZIP 归档包。包内的所有图片资源必须同时满足两个标准：

1. Manifest 清单注册：在内容包文档（通常为 .opf 文件）的 <manifest> 节点下，必须声明图片项，并包含唯一的 id、正确的 href 路径与对应的 MIME 类型（如 image/png、image/jpeg）。
2. 相对路径解析与大小写敏感：XHTML 文档中的 <img> 标签通过相对 URI 引用资源。由于 EPUB 运行环境遵循严格的 URI 规范，路径对英文字母大小写敏感，且必须与实际物理存放路径分毫不差。

需要特别说明的是，即便使用官方 EPUBCheck 等工具校验通过，也不等同于所有终端阅读器都能无缝兼容。校验工具用于检查规范问题，实际阅读器测试用于检查显示结果，两者需要结合。引用路径正确也不能保证图片编码格式在所有阅读器中兼容。

典型排查示例与验证验收

为了更直观地理解路径问题，以下提供一个针对无 DRM 文件的排查示例：

假设排查样本： 设测试文件副本解压后目录结构如下：

OEBPS/
  ├── content.opf
  ├── text/
  │   └── chapter1.xhtml
  └── images/
      └── diagram-01.png

常见错误场景与排查方法：

• 场景 A：相对路径跳级遗漏

若 chapter1.xhtml 中写为 <img src="images/diagram-01.png" alt="示意图" />，由于 HTML 文件处于 text/ 子目录，阅读器会尝试在 OEBPS/text/images/ 寻找资源导致 404 裂图。正确引用应为 ../images/diagram-01.png。

• 场景 B：文件名大小写不一致

若实际文件为 diagram-01.png，但在 XHTML 或 OPF 清单中误写为 diagram-01.PNG，在部分阅读器引擎中即会判定资源缺失。

• 场景 C：清单未注册

若物理文件存在，但 content.opf 的 <manifest> 中遗漏了该项声明，会造成包清单不完整；校验工具可能报错，不同阅读器对缺失声明的容错行为也不同。这不是访问授权机制。

验收步骤： 创作者在修正代码并重新打包为 ZIP（重命名为 .epub，并确保 mimetype 文件作为首个非压缩文件存储）后，必须使用 EPUB 校验工具验证基本语法，并在至少两款不同渲染内核的阅读器中打开，翻阅至对应图表位置，确认图像能够即时、完整呈现。

无法自行解决的情形与权责边界

在排查过程中，存在部分普通用户无法通过本地调整解决的客观限制：

1. DRM 加密与版权保护：若书籍购自商业电子书平台并带有 DRM 保护，图片数据可能经过加密处理。应先在该平台授权的阅读器中检查，再联系购买渠道或出版方获取支持；本文的解包排查步骤不适用于绕过保护。
2. 外部网络链接失效：EPUB 在规范规定的条件下可以引用远程资源；如果图片使用外部 http/https 链接，当离线阅读或远程图床失效时图片即丢失。
3. 平台与服务边界：AI Lab 仅提供排查方法与规范科普，本站不提供在线文件解密、云端修复或文件代改服务。