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 僅提供排查方法與規範科普，本站不提供在線文件解密、雲端修復或文件代改服務。