Bitbucket Pull Request Microsoft 365 Copilot 連接器將 Bitbucket 的拉取請求內容整合進 Microsoft 365，讓 Copilot、Copilot Search 和 Microsoft Search 能直接在 Microsoft 365 中顯示相關的拉取請求與工程上下文。 本文提供你在部署 Bitbucket Pull Request 連接器時可能遇到的常見錯誤的故障排除資訊。
Bitbucket 拉取請求連接器故障排除
下表列出常見錯誤、可能原因及解決步驟。
| 錯誤訊息 | 可能原因 | 解決方案 |
|---|---|---|
| 資料來源無法存取 | 無法連上 Bitbucket API。 網路問題或 Bitbucket 斷線。 | 請查看 Bitbucket 狀態頁面。 這個問題可能是暫時性的——稍後再試。 |
| 原始碼限速爬行 | 對 Bitbucket API 的 API 請求太多， (HTTP 429) 。 | 自動重試，指數倒退 (30秒，速率為2倍) 。 如果持續，請減少爬行頻率。 |
| 認證錯誤 | OAuth 令牌無效、過期或缺少 HTTP 401) (。 應用程式的帳號資料可能不正確。 | 用有效的 Bitbucket OAuth 憑證重新認證連線。 驗證 OAuth 應用程式的客戶端 ID 和秘密。 |
| 授權錯誤 | 存取 HTTP 403) 工作空間/儲存庫權限不足 (。 | 確保 OAuth 應用程式有儲存庫、帳號、拉取請求的範圍。 確認使用者擁有對資料庫的讀取權限。 |
| 資格已過期 | OAuth 刷新令牌無效或已過期。 | 重新認證並取得新的 OAuth 代幣。 檢查 Bitbucket 設定中 OAuth 應用程式的存取權限是否被撤銷。 |
| 恆等映射錯誤 | Bitbucket 的使用者身份與 Microsoft Entra ID 屬性不符。 | 使用電子郵件、登入或姓名設定身份映射。 如果直接映射失敗，請使用正則表達式轉換。 |
| 預覽內容時找不到可搜尋的項目 | 預覽後沒有結果。 沒有 PR 連接器) (拉取請求，也沒有可搜尋的文件 (知識連接器) 。 | 公關： 確保至少有一個拉取請求存在於選定的儲存庫中。 知識： 確保至少有一個 .md 或 .txt 檔案存在於指定的儲存庫中。 |
| 內部誤差 | 爬行操作時出現意外錯誤。 | 檢查連接器日誌。 如果堅持不懈，請聯絡客服。 |