

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

# 问题排查
<a name="ct-troubleshooting"></a>

连接被拒绝或服务器未运行  
持续现代化 CLI 需要一台正在运行的服务器。从开始`atx ct server &`并使用进行验证`atx ct status --health`。

发现扫描返回的存储库为零  
对于本地源，请验证它`--path`指向包含存储库作为子目录的父目录（例如，`/home/user/repos`），而不是直接指向存储库（例如`/home/user/repos/my-app`）。扫描器会查找包含`.git`文件夹的子目录。

SETUP\_必填错误  
来源存在于您的账户中，但未在此计算机上配置凭据。运行`atx ct source add --name {{name}}`以在本地配置凭据。

需要进行身份验证错误  
未找到该来源的有效令牌。验证您的令牌是否正确且具有所需的范围。对于 GitHub，请确保令牌具有`repo`作用域。对于 GitLab，请确保`api`范围。

INVALID\_INPUT 错误  
验证您使用的分析类型名称是否正确。有效值为: `rapid-techdebt-analysis`, `tech-debt-comprehensive`, `security`, `agentic-readiness`, `modernization-readiness`, `custom`。

修复期间出现权限错误  
修复会创建分支和 pull/merge 请求，这需要对存储库的写入权限。使用写入权限更新您的令牌。对于 GitHub，请确保全`repo`范围。对于 GitLab，请确保`api`范围。对于 Bitbucket，请确保`write:repository:bitbucket`和`write:pullrequest:bitbucket`作用域。

安全代理安装失败  
验证您的 IAM 用户或角色是否具有安全代理设置部分中列出的必需 AWS CloudFormation IAM 和 Amazon S3 权限[操作方法 AWS 转变持续的现代化工作](continuous-modernization.md#ct-how-it-works)。使用检查状态`atx ct setup security-agent --status`。

在 Web 应用程序中看不到持续的现代化  
如果在登录 Trans AWS form Web 应用程序后未出现持续现代化，请使用启用转换的 AWS 账户 位置 AWS 的 IAM 凭证登录，而不是 AWS IAM 身份中心。要查看步骤，请参阅[AWS 转换 Web 应用程序（可选）](ct-working-with.md#ct-web-application)。