Calibre 元數據下載失敗：如何核對書目來源及封面？

Calibre 元數據下載失敗，並不表示電子書或書庫已損壞。先保留原有記錄、核對版本標識，再比較同一來源的文字及封面請求，最後才改變網絡路徑；搜尋結果必須符合你實際持有的書。

關鍵要點

• 先診斷一本書，再考慮整個書庫下載。
• 有效的 ISBN 也可能屬於另一版本。
• 書目文字與封面圖片須分開驗收。
• 接受新配對前保留正確欄位。
• 連線比較不能補出來源未收錄的書目。

Calibre 元數據下載失敗應先分清甚麼？

先辨別沒有配對、來源連線錯誤及結果無法儲存。欠缺可搜尋標識需要改善查詢，逾時需要檢查連線，權限錯誤則涉及書庫目的位置，不能當成同一故障處理。

若其他應用程式也有儲存或連線問題，先參考裝置層面的排障次序。這裏只追蹤書目記錄、指定來源及請求停止的環節。

觀察	可能方向	下一步
沒有配對，也沒有連線錯誤	查詢或來源覆蓋	核對版本與標識
一個來源失敗，另一個有結果	個別來源問題	記錄外掛及完整錯誤
文字返回，封面沒有返回	獨立圖片請求或圖片缺失	另行測試封面
結果相似但版本不符	配對問題	拒絕結果並細化標識
正確結果無法儲存	書庫權限或儲存空間	保留結果，檢查本機寫入

表格只協助選擇測試，不能證明根因。將最初錯誤與每次修改的結果一併記錄，不要同時換來源、修改標識和換網絡，否則成功後也難以判斷是哪項改動有效。

步驟 1：你正在保留哪本書及哪個版本？

選取一本書並開啟 Edit metadata。請求前把現有書名、作者、標識、系列資料及自訂標籤寫入本機筆記；有價值的封面另外保存。需要完整備份時，官方 FAQ 建議保存整個書庫資料夾，而非只複製看得到的電子書檔案。［2］

將標識與手上版本比較。平裝、精裝、譯本及電子版本可能使用不同標識；ISBN 通過格式驗證，只表示結構有效，並不證明它屬於這本書。不要為了取得搜尋結果而換成另一版的號碼。

官方編輯器可按書名和作者搜尋，輸入 ISBN 後會優先使用該號碼。先檢查 Ids 欄位，再考慮只按書名查詢；若為對照暫時移除標識，先抄下舊值，以便還原，避免失去有用資料。［3］

對照書應是你熟悉並合法持有的書。冷僻名稱或不完整標識不適合證明網絡故障，來源可能沒有該記錄。不要將整本書上載到無關的書目或檔案測試網站。

步驟 2：哪些 Calibre 元數據來源正在啟用？

查看目前版本的元數據下載設定，記錄已啟用的來源外掛。版本及選用外掛會改變清單，應按實際配置處理，不照搬舊討論區的服務名單。

若要縮窄診斷，官方 fetch-ebook-metadata 可用 --allowed-plugin 指定外掛、--isbn 指定號碼，以及 --verbose 顯示日誌。名稱須使用已安裝命令接受的拼寫；命令只是可選工具，不要求取代圖形編輯器。［1］

選擇你有權使用的來源，只查詢同一本書一次，記錄無配對、逾時、登入相關回應或外掛錯誤。保持書目標識不變，再比較另一個已啟用來源。另一個目錄有答案，只證明它可回應，不能證明原來源恢復。

來源需要帳戶或付費存取時，按官方要求辦理。授權被拒不要反覆重試，也不要把密碼交給不可信外掛；若同一錯誤在獲准的另一網絡持續出現，停止換路，改查來源或外掛。

步驟 3：Calibre 封面下載失敗是否獨立發生？

將書目文字與圖片分開測試。Calibre 批量下載可選元數據、封面或兩者，因此封面單獨失敗，不應令你替換全部文字；診斷時所選清單維持只有一本書。［3］

命令測試須以 --cover 指定封面檔名，否則不會下載圖片。欠缺這個選項時沒有圖片，不能視作連線失敗。輸出先留在書庫以外，確認內容後才決定採用。［1］

先核對返回的書名及標識，再查看圖片是否對應同一版本和語言。來源可能只有文字，也可能把圖片配到另一種出版形式；不要因換網絡後很快返回圖片，便接受錯誤封面。

文字與圖片都失敗時分別保留錯誤。文字正常而圖片逾時，便記錄這個較窄範圍；圖片已收到但寫入失敗，應查看本機位置及權限，不先關閉網絡或安全保護。

步驟 4：受控路徑比較是否適用？

固定書目、外掛及請求種類後，才調查網絡。先查現有 VPN 或過時系統代理是否造成問題。Calibre 預設沿用作業系統代理，支援 HTTP 而非 SOCKS；官方 FAQ 說明了查看目前代理的位置。［2］

Windows 上先核對繼承的代理設定，再考慮增加連線層。終端日誌或支援截圖不應包含帳戶密碼；機構管理的代理要經管理員批准調整，不能直接繞過工作網絡政策。

來源可用、存取獲准而相同請求在原路徑逾時時，可在執行 Calibre 的電腦經 AethoVPN 比較該來源。桌面測試使用 Pro 或 Premium：Windows 用官方安裝程式，Debian/Ubuntu x64 用 .deb，Mac 依官網設定指南取得配置，再以 VPN 客戶端連線。選目前可用的本國或鄰近位置，開啟全局模式，ISBN 及外掛保持不變。

分別重試文字與封面，記錄哪類成功返回，以及版本是否正確；任何請求變差便停止。改路不能補出缺漏目錄、修正錯誤標識或授予付費來源權限，也不涉及移除 DRM 或下載書籍。若這項獲准的來源比較適合你的故障，可開始 3 天 Pro 試用，重試同一書目來源請求；新用戶每人只有一次。

按原任務的連線驗證方法解讀結果。出口地址改變或來源首頁可開啟，都不及 Calibre 內相同請求成功的證據；一次成功不保證所有外掛及日後請求正常。

步驟 5：如何確認正確配對並安全結束？

接受前逐項核對建議欄位：書名、作者、語言、出版社、出版資料及標識應符合目標版本。只有新值確實更好，才替換原有系列次序和個人標籤；網絡恢復與編輯修正是不同決定。

只把已審查結果套用到測試項目，再重新開啟，確認文字和封面正確保留。儲存失敗應查書庫位置、剩餘空間與寫入權限，不要因線上查詢失敗便搬遷或重建書庫。

若失敗的是瀏覽器下載，而非 Calibre 來源請求，按瀏覽器傳輸及儲存環節檢查。瀏覽器能保存圖片而外掛查不到，或相反，都可能發生，必須分開記錄。

求助資料包括 Calibre 版本、系統、外掛名稱、已隱去敏感資料的錯誤、文字還是圖片失敗，以及同一標識的比較結果。只披露你願意分享的標識，不把整個書庫、來源密碼、代理憑據或受版權保護的內容作為常規證據。

總結

• 請求前固定一本書及既有記錄。
• 分開配對、來源連線、圖片取得及本機儲存。
• 只改變路徑，比較同一來源請求。
• 核對版本後才接受，不以第一個結果結束。

常見問題

有 ISBN 就一定能找到書嗎？

不能保證。ISBN 有助識別，但來源可能未收錄該版本；先核對號碼與目錄，把空結果和逾時分開，再決定是否調查連線。

為何一個元數據來源正常，另一個失敗？

各來源的目錄及請求路徑不同。保持書目查詢不變，記錄失敗外掛的回應；替代來源可提供資料，但不能證明原來源正常。

能只下載封面而保留文字嗎？

可以，下載流程可將封面及元數據分開。先只選一個項目，套用前檢查圖片，尤其要避免同名書的不同版本混淆。［3］

應立即延長逾時設定嗎？

先閱讀錯誤。延長等待可能讓慢請求完成，但不能修正授權拒絕或不存在的記錄；保留原設定，每次只改一項，不反覆啟動大批工作。

換網絡能修正錯誤版本配對嗎？

換路可能恢復失敗請求，卻不會令錯誤版本變正確。人工核對標識及出版資料，拒絕錯配，細化查詢時保留已知正確欄位。

如何知道元數據已恢復？

指定來源須返回目標書目信息，以及已請求且可取得的正確封面。重新開啟儲存項目核對欄位；只開到來源首頁不符合這個判據。

何時停止重試並求助？

同一外掛錯誤在獲准替代網絡仍出現、存取被拒或書庫不能安全儲存時，應停止。提交已遮蔽敏感資料的查詢及失敗環節，不重建書庫或分享憑據。

來源

1. calibre — fetch-ebook-metadata: https://manual.calibre-ebook.com/generated/en/fetch-ebook-metadata.html
2. calibre — Frequently Asked Questions: https://manual.calibre-ebook.com/faq.html
3. calibre — Editing e-book metadata: https://manual.calibre-ebook.com/metadata.html

Sources checked 2026 年 10 月 7 日。

Calibre 標誌取自 Kovid Goyal 原始素材，只作縮放與排版；本封面按 GPLv3+ 提供。 Original source · GPLv3+.

延伸閱讀

• 分清瀏覽器傳輸失敗的環節
• 在原任務驗證 VPN 連線
• 核對 Windows 繼承的代理設定