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

# 疑難排解
<a name="ct-troubleshooting"></a>

連線遭拒或伺服器未執行  
持續現代化 CLI 需要執行中的伺服器。使用 啟動它`atx ct server &`，並使用 進行驗證`atx ct status --health`。

探索掃描會傳回零個儲存庫  
對於本機來源，請確認 `--path`指向的父目錄包含儲存庫作為子目錄 （例如 `/home/user/repos`)，而不是直接指向儲存庫 （例如 )`/home/user/repos/my-app`。掃描器會尋找包含`.git`資料夾的子目錄。

SETUP\_REQUIRED 錯誤  
來源存在於您的帳戶中，但此機器上未設定登入資料。執行 `atx ct source add --name {{name}}` 以在本機設定登入資料。

AUTH\_REQUIRED 錯誤  
找不到來源的有效權杖。驗證您的權杖是否正確，並具有所需的範圍。對於 GitHub，請確保字符具有`repo`範圍。對於 GitLab，請確保`api`範圍。

INVALID\_INPUT 錯誤  
確認您使用的是正確的分析類型名稱。有效值為：`rapid-techdebt-analysis`、`tech-debt-comprehensive`、`security`、`agentic-readiness`、`modernization-readiness`、`custom`。

修復期間的許可錯誤  
修復會建立分支和提取/合併請求，這需要對儲存庫的寫入存取權。使用寫入許可更新您的字符。對於 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 應用程式中看不到持續現代化  
如果登入 AWS Transform Web 應用程式後未出現持續現代化，請使用啟用 AWS Transform 之 的 IAM 登入 AWS 帳戶 資料登入，而非 AWS IAM Identity Center。如需這些步驟，請參閱 [AWS 轉換 Web 應用程式 （選用）](ct-working-with.md#ct-web-application)。