本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 故障診斷知識庫
<a name="troubleshooting-knowledge-bases"></a>

當您遇到快速知識庫的問題時，您可以使用此故障診斷指南來識別和解決常見問題。知識庫問題通常涉及文件同步、重新整理任務失敗或存取許可。

## 文件不會顯示在您的知識庫中
<a name="documents-not-appearing"></a>

當您預期看到的文件未出現在知識庫中時，有幾個因素可能會導致此問題。

**常見原因：**
+ **同步進行中** – 文件可能仍在處理中。檢查重新整理狀態以確認重新整理完成。
+ **不支援的檔案格式** – 確認您的文件為支援的格式。如需支援的格式和大小限制，請參閱 [檔案大小和內容限制](knowledge-base-integrations.md#file-size-and-content-limits)。
+ **檔案大小太大** – 驗證檔案是否在大小限制內。如需詳細資訊，請參閱[檔案大小和內容限制](knowledge-base-integrations.md#file-size-and-content-limits)。
+ **存取許可不足** – 確認知識庫具有存取文件來源的適當許可。
+ **文件篩選** – 檢查篩選條件或排除規則是否阻止某些文件編製索引。

**若要疑難排解：**

1. 檢閱重新整理歷史記錄，了解與無法同步的特定文件相關的錯誤訊息。

1. 驗證您的文件格式和檔案大小是否符合要求。

1. 檢查您的存取許可和連線設定。

## 重新整理任務失敗
<a name="refresh-job-fails"></a>

當知識庫或資料來源連線發生組態錯誤時，重新整理任務通常會失敗。

**常見原因：**
+ **許可問題** – 整合缺乏足夠的許可來存取資料來源。
+ **組態錯誤** – URLs或資料來源連線設定不正確。
+ **資源限制** – 來源系統的速率限制。

**若要解析：**

1. 檢查重新整理歷史記錄詳細資訊是否有特定錯誤訊息。

1. 確認已正確設定所有連線設定和許可。

1. 根據錯誤訊息採取建議的動作。

## 重新整理任務完成時發生問題
<a name="refresh-job-completes-with-issues"></a>

當重新整理任務完成時發生問題，任務已成功處理，但部分文件發生問題。

**這表示：**
+ **部分成功** – 有些文件已成功同步，有些則失敗。
+ **文件層級錯誤** – 個別檔案可能有格式問題、損毀或存取問題。
+ **中繼資料問題** – 文件中繼資料或相關資訊的問題。
+ **大小或格式違規** – 有些檔案可能超過大小限制，或是格式不受支援。

**若要解析：**

1. 檢閱詳細的重新整理報告，以識別遇到問題的文件。

1. 解決個別文件問題。

1. 解決問題後執行另一個重新整理。

## 重新整理任務成功，但沒有文件顯示
<a name="refresh-job-succeeds-no-documents"></a>

如果重新整理任務顯示為成功，但知識庫中沒有文件出現，請檢查這些潛在原因。

**常見原因：**
+ **空白來源** – 設定的資料來源位置不包含文件。
+ **路徑組態不正確** – 來源路徑或連線設定不會指向正確的位置。
+ **文件篩選條件** – 包含或排除標準可能會篩選掉所有文件。
+ **缺少讀取許可** – 工作連線成功，但缺少讀取實際文件的許可。

**若要解析：**

1. 驗證資料來源組態是否指向正確的位置。

1. 確認文件存在於指定的位置。

1. 檢查是否已設定適當的存取許可。

1. 檢閱任何可能排除內容的文件篩選條件。

## 重新整理期間的檔案格式問題
<a name="file-format-issues"></a>

快速知識庫支援特定的檔案格式。檔案必須符合格式、大小和字元限制要求。如需支援格式和限制的完整清單，請參閱 [檔案大小和內容限制](knowledge-base-integrations.md#file-size-and-content-limits)。

**若要解決格式問題：**

1. 驗證您的檔案符合格式和大小要求。

1. 將不支援的格式轉換為支援的格式。

1. 從檔案移除密碼保護。

1. 檢查檔案是否未損毀。

## 存取遭拒錯誤
<a name="access-denied-errors"></a>

存取遭拒錯誤通常會因為身分驗證或授權問題而發生。

**常見原因：**
+ **無效登入**資料 – 身分驗證字符或密碼可能已過期。
+ **許可不足** – 整合中使用的帳戶缺少資料來源的讀取存取權。
+ **網路限制** – 防火牆或安全政策會封鎖存取。
+ **SSL/TLS 問題** – 安全連線的憑證問題。

**若要解析：**

1. **驗證身分驗證憑證** – 確認身分驗證憑證是最新且有效的。編輯整合以重新驗證和產生新的字符。

1. **對於 Web 爬蟲程式資料來源** – 確認安全連線已正確設定，且 SSL 憑證已正確設定且受信任。

1. **聯絡您的系統管理員** – 如果您持續遇到存取問題，請聯絡您的系統管理員。他們可能需要調整許可或安全設定。

## ACL 驗證錯誤
<a name="acl-validation-errors"></a>

如果您的同步報告顯示狀態為 **SKIPPED** 且錯誤類型為 **VALIDATION\_ERROR** 的項目，且訊息為「檔案在 crawlACL 為 true 時沒有 ACL，略過擷取」，則您的知識庫連接器所使用的應用程式註冊缺少必要的 ACL 許可。

**若要解析：**

1. 確認應用程式註冊具有適用於 ACL 爬取的正確 API 許可。所需的許可因連接器而異。請參閱連接器設定文件中的許可區段。

1. 確認已針對所有必要的許可授予管理員同意。

1. 修正許可後重新執行完整同步。

## 同步執行超過執行時間上限
<a name="sync-exceeds-maximum-runtime"></a>

如果同步執行需要超過 14 天，Amazon Quick 會以 **FAILED** 狀態結束執行，並*超過訊息的同步時間上限*。這通常發生在知識庫設定為爬取的內容超過單次執行中可以處理的內容時。

**若要解析：**

1. 編輯您的知識庫，以減少每次同步的內容量。套用包含或排除篩選條件、限制要編目的檔案類型或資料夾，或將內容分割到多個知識庫。

1. 對於 Web 爬蟲程式資料來源，如果您的目標是與 等大型公有網站聊天，請考慮改用 Web 搜尋功能`wikipedia.org`。

1. 縮小範圍後再次執行同步。

如需此限制的詳細資訊，請參閱 [最長同步持續時間](knowledge-base-integrations.md#maximum-sync-duration)。