本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
疑難排解
本節提供使用 AWS 轉換自訂疑難排解常見問題的指引。
日誌位置
AWS Transform CLI 會在下列位置維護日誌：
對話日誌：
這些日誌包含用於偵錯特定轉換執行的完整對話歷史記錄。
子代理程式日誌：
這些日誌包含來自子代理程式的輸出，主要代理程式會在轉換期間產生這些輸出。您不需要直接管理子代理程式。
開發人員偵錯日誌：
這些日誌提供有關 CLI 操作和錯誤的詳細資訊。每個日誌檔案在滾動之前都有 5MB 的限制。此目錄中可能有多個偵錯日誌，例如 debug1.log 和 debug2.log。
常見問題
安裝問題：
如果安裝失敗，請確保您已安裝 Node.js 22 或更新版本：
node --version
如有需要，請從 https://nodejs.org/en/download：// 下載 Node.js。
身分驗證問題：
確認您的 AWS 登入資料設定正確：
aws sts get-caller-identity
確保您的 IAM 使用者或角色具有必要的transform-custom:*許可。
網路連線問題：
如果您遇到連線錯誤，請驗證對必要端點的網路存取：
transform-cli.awsstatic.com.rproxy.govskope.catransform-custom.<region>.api.aws*.s3.amazonaws.com
如果在網際網路限制的環境中工作，請更新防火牆規則以允許列出這些 URLs。
區域組態問題：
如果您遇到與區域相關的錯誤：
驗證您的區域是否受到支援
檢查可能覆寫您組態的環境變數：
echo $AWS_REGION $AWS_DEFAULT_REGION檢查您的區域組態：
aws configure get region如有需要，請更新您的區域：
aws configure set region <your-region>檢查偵錯日誌以取得區域解析詳細資訊
Git 問題：
確定已安裝 Git，且您的儲存庫受到 git 來源控制：
git --version git status
AWS 轉換自訂需要儲存庫在 git 來源控制下。
轉換執行問題：
如果轉換失敗：
在 檢閱對話日誌
~/.aws/atx/custom/<conversation_id>/logs/檢查轉換輸出中的建置或測試失敗
確認您的專案的 build 命令正確
嘗試在互動式模式下執行轉換，以提供意見回饋
對話恢復問題：
如果您無法繼續對話：
驗證對話是否少於 30 天
檢查對話 ID 是否正確
確定您有網路連線能力
取得支援
如需其他協助，請透過AWS 主控台
開啟支援票證時，請包含：
來自 的對話日誌
~/.aws/atx/custom/<conversation_id>/logs/來自 的子代理程式日誌
~/.aws/atx/custom/<conversation_id>/logs/subagents/從 偵錯日誌
~/.aws/atx/logs/重現問題的步驟
AWS 轉換 CLI 版本 (
atx --version)
S3 存取問題
AWS 轉換自訂服務提供 S3 預先簽章URLs，以協助在用戶端機器之間上傳和下載潛在的大型轉換檔案。這表示 CLI 不僅會與 AWS Transform 服務端點互動，也會與 S3 服務端點互動。這些互動使用預先簽章URLs，因此您用戶端的 IAM 登入資料不需要任何 S3 許可，但有時本機電腦的代理伺服器組態和網路的 S3 VPC 端點政策可能會限制此流量。
請檢查 日誌位置 以取得更詳細的錯誤訊息，以協助根導致與下載和上傳轉換檔案相關的任何工具失敗或 S3 存取遭拒。
如果您使用的是利用 https_proxy和 no_proxy環境變數的 VPN/代理伺服器，請考慮將下列值新增至您的no_proxy環境變數值，以略過 S3 的代理並 AWS 轉換自訂服務端點，例如：
如果您在 VPC 中使用AWS 適用於 Amazon S3 的 PrivateLink，則可能已定義政策來限制 S3 流量。請確保您的 S3 VPC 端點政策允許 GetObject和 PutObject操作 AWS 轉換自訂服務擁有的儲存貯體。這可以透過將下列陳述式新增至 VPC 端點政策來完成：
{ "Effect": "Allow", "Principal": "*", "Action": ["s3:PutObject","s3:GetObject"], "Resource": "arn:aws:s3:::aws-transform-custom-*/*" }
政策中的明確Deny陳述式優先於Allow陳述式。檢閱 S3 VPC 端點政策是否有可能限制存取的Deny陳述式。
