亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 排查开发环境的问题
要排查与开发环境相关的问题，请参阅以下部分。有关开发环境的更多信息，请参阅[使用开发环境编写和修改代码 CodeCatalyst使用开发环境编写和修改代码](devenvironment.md)。
**Topics**
+ [由于出现配额问题，我无法创建开发环境](#troubleshooting-devenvironments-create)
+ [我无法将更改从开发环境推送到存储库中的特定分支](#troubleshooting-devenvironments-branchrules)
+ [我的开发环境未恢复](#troubleshooting-devenvironments-resume)
+ [我的开发环境已断开连接](#troubleshooting-devenvironments-connection)
+ [我的与 VPC 连接的开发环境出现问题](#troubleshooting-devenvironments-vpc)
+ [我找不到我的项目位于哪个目录](#troubleshooting-devenvironments-projects)
+ [我无法通过 SSH 连接到我的开发环境](#troubleshooting-devenvironments-connect-ssh)
+ [我无法通过 SSH 连接到我的开发环境，因为我的本地 SSH 配置缺失](#troubleshooting-devenvironments-projects-ssh-config)
+ [我无法通过 SSH 连接到我的开发环境，因为我的 AWS Config `codecatalyst`配置文件有问题](#troubleshooting-devenvironments-config-profile)
+ [当我 CodeCatalyst 使用单点登录账户登录时，我无法创建开发环境](#troubleshoot-create-dev-env-idprovider)
+ [排查 IDE 的问题](devenvironments-troubleshooting-ides.md)
+ [排查 devfile 的问题](devenvironments-devenvironments-devfile.md)
## 由于出现配额问题，我无法创建开发环境
**问题：**我想在中创建一个开发环境 CodeCatalyst，但我看到一个错误。控制台中的开发环境页面上显示一条消息，指示我已达到空间的存储限制。
**可能的修复方法：**根据您在项目或空间中的角色，您可以删除自己的一个或多个开发环境，或者如果您具有空间管理员角色，则可以删除其他用户创建的未使用的开发环境。您也可以决定将计费等级更改为一个包含更多存储空间的计费等级。
+ 要查看存储限制，请查看 Amazon CodeCatalyst 空间的 “**账单**” 选项卡，查看**使用量**配额是否已达到允许的最大值。如果配额已达到最大值，请联系具有空间管理员角色的人员以移除不需要的开发环境或考虑更改计费等级。
+ 要移除您创建的不再需要的任何开发环境，请参阅[删除开发环境](devenvironment-delete.md)。
如果问题仍然存在，并且您的 IDE 中出现错误，请检查您的 CodeCatalyst 角色是否允许您创建开发环境。**空间管理员**角色、**项目管理员**角色和**贡献者**角色都有创建开发环境所需的权限。有关更多信息，请参阅[使用用户角色授予访问权限](ipa-roles.md)。
## 我无法将更改从开发环境推送到存储库中的特定分支
**问题：**我要将开发环境中的代码更改提交并推送到源存储库中的分支，但显示一个错误。
**可能的修复方法：**根据您在项目或空间中的角色，您可能无权将代码推送到项目中的源存储库。**空间管理员**角色、**项目管理员**角色和**贡献者**角色都有权将代码推送到项目中的存储库。
如果您具有**贡献者**角色但无法将代码推送到特定分支，则可能为该特定分支配置了一个分支规则，该规则禁止具有此角色的用户将代码推送到该特定分支。尝试将更改推送到其他分支，或者创建一个分支，然后将代码推送到该分支。有关更多信息，请参阅 [使用分支规则管理分支允许的操作](source-branches-branch-rules.md)。
## 我的开发环境未恢复
**问题：**我的开发环境在停止后未恢复。
**可能的修复方法：**要修复问题，请查看 Amazon CodeCatalyst 空间的 “**账单**” 选项卡，查看**使用**配额是否已达到最大限制。如果配额已达到最大限制，请联系您的空间管理员来提高计费等级。
## 我的开发环境已断开连接
**问题：**我的开发环境在使用期间断开连接。
**可能的修复方法：**要修复此问题，请检查您的 Internet 连接。如果您未连接到 Internet，请连接开发环境并继续工作。
## 我的与 VPC 连接的开发环境出现问题
**问题：**我将 VPC 连接关联到我的开发环境，但出现错误。
**可能的修复方法：**Docker 使用了一种名为网桥网络的链路层设备，它使连接到同一网桥网络的容器能够进行通信。默认网桥通常使用 `172.17.0.0/16` 子网进行容器联网。如果环境实例的 VPC 子网使用的地址范围与 Docker 使用的相同，则可能会出现 IP 地址冲突。要解决由 Amazon VPC 和Docker使用相同 IPv4 CIDR 地址块引起的 IP 地址冲突，请配置与不同的 CIDR 块。`172.17.0.0/16`
**注意**
您不能更改现有 VPC 或子网的 IP 地址范围。
## 我找不到我的项目位于哪个目录
**问题：**我找不到我的项目位于哪个目录
**可能的修复方法：**要找到您的项目，请将目录更改为 `/projects`。您可以在此目录中找到您的项目。
## 我无法通过 SSH 连接到我的开发环境
要排查通过 SSH 与开发环境建立的连接的问题，您可以执行带 `-vvv` 选项的 `ssh` 命令，以显示有关如何解决问题的更多信息：
```
ssh -vvv codecatalyst-dev-env===
```
## 我无法通过 SSH 连接到我的开发环境，因为我的本地 SSH 配置缺失
如果本地 SSH 配置（`~/.ssh/config`）缺失或 `Host codecatalyst-dev-env*` 部分的内容已过期，则您将无法通过 SSH 连接到您的开发环境。要解决此问题，请删除 `Host codecatalyst-dev-env*` 部分并重新从 **SSH 访问权限**模式执行第一条命令。有关更多信息，请参阅 [使用 SSH 连接到开发环境](devenvironment-connect-ssh.md)。
## 我无法通过 SSH 连接到我的开发环境，因为我的 AWS Config `codecatalyst`配置文件有问题
确保您的`codecatalyst`个人资料的 AWS Config (`~/.aws/config`) 与中描述的相匹配[设置为 AWS CLI 与一起使用 CodeCatalyst](set-up-cli.md)。如果不是这样，请删除 `codecatalyst` 的个人资料并重新从 **SSH 访问权限**模式执行第一条命令。有关更多信息，请参阅 [使用 SSH 连接到开发环境](devenvironment-connect-ssh.md)。
## 当我 CodeCatalyst 使用单点登录账户登录时，我无法创建开发环境
**问题：**当我以 SSO 用户身份登录 CodeCatalyst 控制台时，当我选择在空间中创建开发环境时，我收到一个未知的异常错误。当我选择创建开发环境并选择 IDE 进行访问时（例如） AWS Cloud9，我遇到了类似以下的问题：
+ CodeCatalyst 控制台中的**开发环境**页面在列表中显示带有`FAILED`状态的开发环境。
+ 这将显示一条与以下内容类似的错误消息：
**`An unknown exception happened`**
`We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`
**可能的修复方法：**
开发环境不适用于将 Active Directory 用作身份提供商的空间中的用户。该空间的管理员可以使用其他身份提供商来访问开发环境，例如 IAM Identity Center。有关规划支持身份联合的空间的更多信息，请参阅*《CodeCatalyst 管理员指南》*中的 “[规划支持身份联合的空间](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation)”。