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

# GitLab Duo with Amazon Q 問題故障診斷
<a name="gitlab-troubleshooting"></a>

請參閱下一節，了解如何針對使用 GitLab Duo with Amazon Q 時的常見上線問題進行故障診斷。

## GitLab 執行個體封鎖傳入請求
<a name="gitlab-troubleshooting-blocked-instance"></a>

**問題**：我的 GitLab 執行個體封鎖傳入請求，且 Amazon Q 無法回呼我的 GitLab 執行個體。

**解決方案**：找出封鎖傳入請求的項目，並進行修改，以接受來自 Amazon Q 的傳入請求，其可能為下列其中一種形式：
+ 代理
+ 防火牆層
+ 任何基礎結構層的拒絕清單或允許清單

您需要重新加入 GitLab 執行個體才能重新同步。如需詳細資訊，請參閱 *GitLab 文件*中的[設定 GitLab Duo with Amazon Q](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## Gitlab 與 Amazon Q 之間的連線不同步
<a name="gitlab-troubleshooting-connection-sync"></a>

**問題**：我修改了 GitLab Duo with Amazon Q 應用程式，現在 GitLab 與 Amazon Q 之間的連線不同步。

**解決方案**：GitLab 與 Amazon Q 不同步時，可能會導致憑證無效、無法重新整理憑證，以及當 Amazon Q 呼叫 GitLab 時，GitLab 發出未經授權的回應。

## 執行個體網域名稱無法解析
<a name="gitlab-troubleshooting-instance-domain"></a>

**問題**：我在上線後修改了 GitLab 執行個體 URL，現在 GitLab 與 Amazon Q 之間的連線不同步。Amazon Q 無法再成功呼叫 GitLab 執行個體。

**解決方案**：您需要確保網域名稱可解析。重新加入您的 GitLab 執行個體。如需詳細資訊，請參閱 *GitLab 文件*中的[設定 GitLab Duo with Amazon Q](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## 不正確的 IAM 角色和身分提供者 (IdP)
<a name="gitlab-troubleshooting-iam-role-idp-setup"></a>

**問題**：我的 IAM 角色未將 GitLab Duo with Amazon Q 所需的正確許可提供給 API。

**解決方案**：確認已正確設定身分提供者 (IdP) 和 IAM 角色。如需詳細資訊，請參閱 *GitLab 文件*中的[設定 GitLab Duo with Amazon Q](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## Amazon Q Developer 設定檔不存在
<a name="gitlab-troubleshooting-profile"></a>

**問題**：我嘗試加入 GitLab Duo with Amazon Q，但遇到以下問題：`Application could not be craeted by the AI Gateway: Error 400 - {"detail":"An error occured (ValidationException) when calling the CreateOAuthAppConnection operation: ProfileDoesNotExist"}`

**解決方案**：您必須先透過 Amazon Q Developer 主控台建立 Amazon Q Developer 設定檔。如需詳細資訊，請參閱 *GitLab 文件*中的[設定 GitLab Duo with Amazon Q](https://docs.gitlab.com/user/duo_amazon_q/setup/)。