如何修復 Kodi 的「安裝依賴項失敗」錯誤

如果 Kodi 顯示“安裝依賴項失敗”，則表示您選擇的插件需要另一個 Kodi 元件，但 Kodi 無法找到、下載或安裝該元件。解決方法取決於缺少的元件：檢查其確切名稱，確認該外掛程式支援您的 Kodi 版本，然後修復提供該元件的受信任儲存庫或連接。切勿僅因檔案名稱匹配就隨意下載 ZIP 檔案。

依賴項錯誤是什麼意思

Kodi插件可以在其軟體包資訊中聲明所需的插件或模組。 Kodi會在安裝過程中解析這些需求，並檢查所需的元件及其版本是否可用。因此，錯誤可能意味著某個依賴項在所有已啟用的儲存庫中都不存在，或無法存取該儲存庫，又或該外掛程式需要比已安裝的版本更新的Kodi或平台版本。 Kodi插件格式文件解釋瞭如何聲明所需的元件和最低版本。

請依此順序縮小故障原因範圍，然後再移除外掛程式或變更 Kodi 設定。

1. 記錄附加元件和缺少的依賴項

Kodi 事件日誌畫面顯示插件安裝失敗和先前的儲存庫更新事件 — Kodi 事件日誌範例。安裝失敗的條目可以幫助您在重新啟動前發現問題。

出現錯誤時，請記下對話方塊中顯示的插件名稱和相依性名稱。如果名稱缺失或消失，請再次嘗試安裝，並立即從「設定」功能表開啟 Kodi 的「事件日誌」。日誌中包含插件安裝失敗的記錄，並且會在 Kodi 重新啟動後清除，因此請在重新啟動前檢查日誌。

事件日誌是重要的初步線索，但它可能無法解釋安裝失敗的原因。 Kodi事件日誌指南介紹如何找到它以及它會記錄哪些事件。

2. 檢查 Kodi 和插件的兼容性

Kodi插件資訊面板顯示了一個未安裝的必需相依性範例以及版本相容性警告 — 插件資訊範例視圖，展示了缺少元件與 Kodi 版本不匹配之間的差異。

開啟插件的資訊頁面，查看其版本、作者和相依性清單。將其列出的 Kodi 和作業系統要求與您已安裝的 Kodi 版本和裝置進行比較。某些元件可能缺失，因為該插件是為不同的 Kodi 版本、架構或平台建構的。

Kodi官方軟體庫中的插件是按相容的Kodi版本分類的。對於手動安裝的ZIP文件，相容性由使用者自行負責。在更新、降級或更改版本之前，請務必查看插件維護者的最新文件；切勿為了測試是否有效而安裝開發版本。如果Kodi本身需要更新，請使用Kodi官方下載頁面或作業系統提供的可信任軟體套件來源。

3. 檢查提供依賴項的儲存庫

Kodi插件瀏覽器已選取“從儲存庫安裝”，且Kodi插件儲存庫已高亮顯示。 — 範例庫瀏覽器。首先使用 Kodi 自帶的函式庫，然後向函式庫維護者驗證任何其他來源。

在 Kodi 中，開啟「插件」>「從庫安裝」，檢查該插件或其依賴項是否可在 Kodi 插件庫中找到。如果第三方外掛程式需要來自其自身庫的元件，請確認該程式庫已啟用，且外掛程式的維護者仍在其中發布該元件。只有當已啟用的庫中存在適當的元件時，Kodi 才能自動安裝依賴項。

如果 Kodi 報告無法取得儲存庫訊息，請檢查裝置的網路連線並嘗試刷新儲存庫。頁面缺失或重複出現 404 錯誤通常表示儲存庫位址或軟體包已被移除；這並非使用舊指南中名稱相似的儲存庫進行替換的理由。僅停用或卸載您確認已過時或不再信任的儲存庫。 Kodi 警告稱，透過 ZIP 檔案安裝的插件和儲存庫可以存取裝置上的個人數據，因此請僅使用您可以驗證的來源。有關詳細信息，請參閱官方插件管理器指南和官方存儲庫概述。

4. 如果原因仍然不明確，請使用偵錯日誌。

Kodi調試日誌範例，突出顯示了儲存庫獲取失敗和缺少插件依賴項的問題。 — 範例調試日誌。請尋找安裝失敗附近出現的第一個儲存庫或相依性錯誤。

在「設定」>「系統」>「日誌記錄」中啟用調試日誌記錄，使用 Kodi 的電源選單重新啟動 Kodi，然後重複失敗的安裝步驟一次。之後檢查kodi.log或使用 Kodi 的日誌檔案special://logpath位置。日誌路徑因平台而異；例如，Windows 通常使用 `/usr/local/bin` ， %APPDATA%\Kodi\kodi.logmacOS 使用 `/usr/local/bin` ~/Library/Logs/kodi.log，Linux 使用 `/usr/local/bin`。 Android的日誌~/.kodi/temp/kodi.log檔案路徑因裝置而異。 Kodi 的日誌檔案指南列出了更多日誌檔案位置，並解釋如何擷取偵錯日誌。

安裝失敗前後，搜尋依賴項 ID、「取得失敗」、「404」、「逾時」或版本要求等錯誤訊息。逾時通常表示連接問題；404 錯誤或缺少儲存庫條目表示軟體包不可用；版本要求表示插件/Kodi 相容性問題。收集所需資訊後，請關閉調試日誌記錄。分享日誌前，請檢查是否包含個人信息，例如帳戶名稱、文件路徑或儲存庫詳細資訊。

當依賴項不再可用時

如果外掛程式維護者已停止發布所需元件，或者該外掛程式不支援您的 Kodi 版本，則可能無法安全地修復您目前的設定。請從官方倉庫或您可以驗證的開發者來源中選擇一個維護良好的替代方案。切勿安裝未經驗證的 ZIP 檔案、恢復已停用的倉庫或停用安全檢查以強制安裝。如果您需要協助，請提供 Kodi 版本、裝置平台、外掛程式名稱、確切的依賴項 ID 以及已審核的日誌摘錄。