對 OneDrive 資料來源進行故障診斷

使用此頁面來診斷 OneDrive 身分驗證、資料來源建立和同步的常見問題。如需文件層級存取控制的特定問題，請參閱中的故障診斷表文件層級存取控制。

資料來源建立和連線錯誤

建立和連線錯誤
徵狀	可能原因	修正
資料來源無法建立，且錯誤`certificateS3Path`不得為 null。	`aclEnabled` 為，`true`但未提供憑證路徑。文件層級存取控制需要憑證。	`certificateS3Path` 新增至 `connectionConfiguration`，指向 Amazon S3 中的`.p12`憑證。請參閱設定 OneDrive 的 Microsoft Entra App ID 身分驗證。
租用戶 ID 無效。	租用戶 ID 格式錯誤或不符合您的 Microsoft Entra 租用戶。	從 Microsoft Entra 管理中心的應用程式概觀頁面複製目錄（租戶） ID。
無效的用戶端 ID，或找不到應用程式。	秘密`clientId`中的不正確，或應用程式註冊不存在。	從應用程式概觀頁面複製應用程式（用戶端） ID，並更新秘密。
無法連線至 OneDrive。	一或多個登入資料不正確，或應用程式缺少必要的許可或管理員同意。	驗證秘密值、確認應用程式許可，並授予管理員同意。請參閱設定 OneDrive 的 Microsoft Entra App ID 身分驗證。
知識庫服務角色無法讀取憑證。	憑證物件`s3:GetObject`上缺少服務角色，或使用角色無法使用的客戶受管金鑰來加密物件。	`s3:GetObject` 授予憑證，如果物件使用客戶受管 KMS 金鑰，`kms:Decrypt`則授予該金鑰。請參閱步驟 8 （僅限 ACLs)：授予憑證的服務角色存取權。

憑證錯誤
徵狀	可能原因	修正
即時存取驗證期間的憑證密碼或權杖思維錯誤。	`.p12` 密碼與秘密`certificatePassword`中的不相符。	將 `certificatePassword`設定為用來建立`.p12`檔案的密碼，或使用已知密碼重新建立套件。
存取驗證在之前有效，現在所有查詢都會傳回零結果。	憑證已過期，或管理員同意已撤銷。	產生新憑證、將公有憑證上傳到 Entra 應用程式註冊、取代 Amazon S3 `.p12`中的，以及重新授予管理員同意。請參閱輪換憑證。
憑證無法載入為 PKCS#12 的錯誤（例如，「無效的憑證格式」)。	`certificateS3Path` 指向錯誤的物件（例如 `.cer`/PEM 檔案），或秘密`certificatePassword`中的與套件不相符。文件層級存取控制需要 `.p12` 格式。	確認 `certificateS3Path` 指向您的`.p12`套件，且`certificatePassword`符合該套件。

如果您使用文件層級存取控制，請在憑證過期之前輪換憑證。過期的憑證會導致即時存取驗證失敗，因此查詢會傳回零結果。若要在不中斷存取的情況下進行輪換，請將新憑證上傳為單獨的物件，並將資料來源切換至該物件，以便現有憑證在您切換之前繼續運作。

產生新的憑證和 PKCS#12 (.p12) 套件，如中所述設定 OneDrive 的 Microsoft Entra App ID 身分驗證。
在您的 Entra 應用程式註冊中，在憑證和秘密下，上傳新的公有憑證。保留現有的憑證 — 應用程式註冊可以保留多個憑證。
在新的物件金鑰下將新的.p12套件上傳至 Amazon S3 （請勿覆寫現有的憑證物件）。確認您的知識庫服務角色可以讀取新物件。
更新資料來源，讓 certificateS3Path指向新物件，並更新 AWS Secrets Manager 秘密certificatePassword中的以符合新套件。使用 UpdateDataSource 操作或 AWS 管理主控台。
確認具有授權使用者的擷取會傳回結果，顯示新憑證可用於即時驗證。
確認新憑證正常運作後，請從 Entra 應用程式註冊中移除舊憑證，並從 Amazon S3 刪除舊.p12物件。

OAuth 2.0 錯誤
徵狀	可能原因	修正
同步失敗，並顯示無法重新整理 OAuth 2.0 存取字符的訊息。	秘密缺少 `refreshToken` 欄位，或重新整理字符已過期或已撤銷。	確認秘密包含 `clientId`、 `clientSecret`和 `refreshToken`。如果字符已過期或已撤銷，請取得新的字符並更新秘密。請參閱步驟 4：取得重新整理權杖。
您想要編目與使用者或 OneNote 筆記本共用的檔案，但不編製索引。	資料來源使用 Microsoft Entra App ID （僅限應用程式）身分驗證，無法存取共用檔案或 OneNote 筆記本。	使用`OAUTH2`身分驗證並啟用對應的同步範圍。請參閱設定 OneDrive 的 OAuth 2.0 身分驗證。

同步錯誤
徵狀	可能原因	修正
同步完成，但沒有文件編製索引。	應用程式無法存取設定的使用者磁碟機，或包含或排除篩選條件會排除所有內容。	驗證應用程式許可和管理員同意，並檢閱您的使用者電子郵件和磁碟機項目篩選條件。
特定使用者的內容不會編目。	篩選條件會排除使用者，或使用者沒有可存取的內容。	檢查 `inclusionUserEmailAddresses` 和 `exclusionUserEmailAddresses` 篩選條件，並確認使用者在其磁碟機中有內容。

ACL 設定錯誤不會在擷取期間產生明確的錯誤。相反地，查詢會傳回較少或零的結果。如需 ACL 特定症狀、驗證步驟和修正，請參閱文件層級存取控制。

文件層級存取控制

Microsoft SharePoint