Confluence 本地 Microsoft 365 Copilot 連接器使 Microsoft 365 能夠索引並檢索自自架 Confluence 資料中心或伺服器實例的內容。 它將企業維基內容引入 Microsoft Search 與 Copilot，提升 Microsoft 365 生態系統內的能見度與可用性。
本文提供您在部署或管理 Confluence 本地接頭時可能遇到的常見錯誤的故障排除資訊。
欲驗證 Confluence 設定資訊以協助排除錯誤，請參閱 「設定 Confluence 服務以擷取連接器」。
排除常見錯誤
下表列出 Confluence 本地接頭可能發生的常見錯誤及建議的故障排除步驟。
| 錯誤 | 描述 | 解決方案 |
|---|---|---|
OAuth 因 Invalid connection credentials |
當 Microsoft 365 的管理員不是 Confluence 的管理員時會發生。 | 使用 InPrivate 瀏覽。 請將 OAuth 彈出連結分享給 Confluence 管理員審核。 核准後，貼上 window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*') 控制台。 |
| 外掛未安裝或停用 | 所需的 Confluence 本地外掛缺失或被停用。 | 前往 管理>管理應用程式。 如果外掛還沒安裝，請從 Atlassian 市集下載。 如果是停用的，請啟用。 |
| 缺少行動網頁外掛 | 索引時必須使用 Confluence Mobile Web Plugin。 | 確認外掛是否已安裝並啟用系統 應用程式。 如果缺少，請從 Atlassian 市集下載。 |
| 索引問題 | 使用者因身份不符無法存取已索引的內容。 | 請確保 Confluence 中的電子郵件 ID 與 Microsoft Entra ID 中的 UPN 相符。 對於非 Microsoft Entra ID 使用者，請設定正則表達式映射。 |
| 無內容被索引 | 連接器顯示零索引項目。 | 請檢查空格和頁面權限。 驗證服務帳號是否有讀取權限。 確認空格沒有被歸檔。 |
| 增量爬行無法同步權限更新 | 權限變更不會反映在搜尋結果中。 | 使用完整爬取來同步權限更新。 增量爬取不支援權限變更。 |
| API 限速延遲 | 爬行速度慢是因為伺服器端的限速。 | 檢視 Confluence 伺服器的 API 限制。 如有需要，請透過 Microsoft 支援申請限速調整。 |
| GCA 離線 | 當 Graph Connector Agent 電腦關閉時，連接器無法索引。 | 確保 GCA 電腦在爬行作業時保持在線。 |
| 錯誤的日期篩選器 | 由於日期篩選器設定錯誤，沒有任何頁面被索引。 | 請確保 最後創建日期 早於 最後修改日期。 若未指定日期，所有文件均被索引。 |
排除使用者權限問題
如果使用者在 Microsoft 365 Copilot 或 Microsoft Search 找不到 Confluence 資料中心頁面，而該帳號應該有存取權限，請使用以下步驟進行故障排除。
確認使用者有權限存取 Confluence 資料中心頁面
- 請確保使用者擁有特定 Confluence 資料中心頁面的檢視權限。 欲了解更多資訊，請參閱 「誰可以瀏覽該頁面」。
- 確認頁面、空間及任何父頁面是否授予適當的存取權限。
確認使用者正確對應至 Microsoft Entra 身份
錯誤的使用者身份映射會阻止 Copilot 和 Search 解析權限。 驗證身份映射：
- 根據你的環境檢視地圖設定。 欲了解更多資訊，請參閱 Map 非 Entra ID 身份及 Map Microsoft Entra 身份。
- 檢查使用者映射公式，並視需要更新。 在連接器的 錯誤 標籤中，映射問題通常會以
2006 error.
檢查 Confluence 使用者名或群組名稱中的無效字元
Confluence Data Center 在使用者名稱和群組名稱上有已知的限制。 當使用者或群組名稱包含斜杠 / 或反斜線 \\ 字元時，Confluence 資料中心在管理權限時會以「發生意外錯誤」錯誤訊息時失敗。 Atlassian 已記錄過 Bamboo 的這種行為;同樣的限制也適用於 Confluence 資料中心環境。 欲了解更多資訊，請參閱「 若群組中有同人角色或 Bamboo 用戶名，權限授予失敗」。