本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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使用 Amazon Q 进行设置](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## GitLab 与 Amazon Q 之间的连接不同步
<a name="gitlab-troubleshooting-connection-sync"></a>

**问题**：我修改了 GitLab Duo 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使用 Amazon Q 进行设置](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## IAM 角色与身份提供商（IdP）配置错误
<a name="gitlab-troubleshooting-iam-role-idp-setup"></a>

**问题**：我的 IAM 角色没有提供 Amazon Q 所 APIs 要求GitLab Duo的正确权限。

**解决方案**：确保身份提供商（IdP）和 IAM 角色配置正确。有关更多信息，请参阅*GitLab 文档*中的[GitLab Duo使用 Amazon Q 进行设置](https://docs.gitlab.com/user/duo_amazon_q/setup/)。

## Amazon Q 开发者版配置文件不存在
<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 开发者版控制台创建 Amazon Q 开发者版配置文件。有关更多信息，请参阅*GitLab 文档*中的[GitLab Duo使用 Amazon Q 进行设置](https://docs.gitlab.com/user/duo_amazon_q/setup/)。