容器工具错误消息
本文列出了 Visual Studio 容器工具使用的错误代码，并尽可能提供了有关如何解决问题的建议。
容器工具错误代码
| 代码 | 说明 | 注释 | Fix |
|---|---|---|---|
| CTC1001 | 未启用 Docker 卷共享 | 如果未启用文件共享，会发生此错误。 通过文件共享，可将 Windows 上的本地目录与 Linux 容器共享。 这仅适用于使用 Hyper-V 模式的 Linux 容器。 有关更多详细信息，请参阅适用于 Windows 用户的 Docker Desktop 手册或 Docker 文档。 | 启用 Docker 文件共享。 |
| CTC1002 | 未安装 Docker Desktop | 安装 Docker Desktop。 | |
| CTC1003 | Docker Desktop 未运行 | 启动 Docker Desktop。 | |
| CTC1004 | 无法获取 Docker 服务器 OS | 在项目文件中指定默认的 targetOS；例如，<DockerDefaultTargetOS> Linux </DockerDefaultTargetOS>）。 |
|
| CTC1005 | Docker Desktop 的操作系统模式与项目的目标操作系统不匹配 | 切换 Docker Desktop 操作系统模式以匹配项目的目标操作系统。 | |
| CTC1006 | Docker Desktop 正在运行，但处于错误状态，应重新启动。 | 重启 Docker Desktop 并确保 Docker Desktop 正常运行。 | |
| CTC1007 | 下载 vsdbg 失败，但在磁盘上找到了现有副本 |
这只是一个警告，调试不会失败。 如果无法下载最新版本的 vsdbg，但找到并使用了现有副本，则会出现此警告。 |
不需要用户执行任何操作。 |
| CTC1008 | 下载 vsdbg 失败，且磁盘上未找到任何现有副本 |
F5 未能下载 vsdbg.exe。 |
请检查 Internet 连接。 |
| CTC1009 | 驱动器共享凭据可能无效 | 这可能是由 Docker Desktop 使用的共享驱动器凭据过期造成的。 请尝试在 Docker Desktop 设置的“共享驱动器”页中重置凭据，然后重启 Docker。 | |
| CTC1010 | 当前用户不在 docker-users 组中 |
当前用户不在 docker-users 组中。 请将你自己添加到 docker-users 组，然后注销并返回到 Windows。 |
|
| CTC1011 | 端口在使用中 | 容器正尝试使用处于使用中的特定主机端口。 | 请停止使用此端口的上一个容器或其他应用程序，或更新应用程序以使用不同的端口。 |
| CTC1012 | 未使用 | ||
| CTC1013 | 此当前类型不受支持或不支持 dotnet core 版本 | ||
| CTC1014 | 生成 dockerFile 时出错 | 无法生成 Dockerfile。 更正 Dockerfile 中的错误，然后重试。 | |
| CTC1019 | 未使用 | ||
| CTC1020 | 尝试启动容器时引发 UnauthorizedAccessException | ||
| CTC1021 | 尝试启动容器时引发 SecurityException | ||
| CTC1022 | 未使用 | ||
| CTC1023 | 找不到文件或目录。 | 可能是未找到 dockerfile、Docker 上下文或项目文件。 | |
| CTC1024 | 尝试启动容器时引发 IOException | ||
| CTC1025 | 尝试拉取 Docker 映像时出错。 | 有关 docker pull 命令失败原因的更详细错误信息，请参阅“输出”窗口。 |
|
| CTC1026 | 启动设置解析错误。 | 解析 launchSettings.json 文件中的 IISExpress 设置时找不到 IISExpress 设置或解析失败。 | 请确保 launchSettings.json 中的 IISExpress 设置有效。 |
| CTC1027 | 运行 dev-certs 工具时出错。 |
运行 dev-certs 工具以信任 ASP.NET Core 开发证书时出错。 |
有关更详细的错误信息，请参阅“输出”窗口。 |
| CTC1028 | 启动 URL 无效 | 调试开始时将启动的应用程序 URL 无效 | 请确保在 launchSettings.json 的 Docker 启动设置中指定 launchUrl |
| CTC1029 | Docker 执行失败 | 尝试运行命令以启动容器内的应用程序进程时出错。 | 有关更详细的错误信息，请参阅“输出”窗口。 |
| CTC1030 | 内部错误 | 发生未知内部错误。 | 请在 Visual Studio 反馈中记录一个 bug。 |
| CTC1031 | 不受支持的 OS | 可能是因为在 Linux 容器中使用 .NET Framework 项目。 请切换到 Windows 容器，然后重试。 | |
| CTC1032 | 未使用 | ||
| CTC1033 | 未使用 | ||
| CTC1034 | 未使用 | ||
| CTC1035 | Docker Desktop 下载失败 | 尝试安装 Docker Desktop 时无法下载 Docker Desktop 安装程序 (.msi)。 |
检查 Internet 连接，确保没有防火墙阻止文件下载。 |
| CTC1036 | Docker Desktop 安装失败 | 更正安装程序中的错误，并手动安装 Docker Desktop。 或者，重新打开解决方案，Visual Studio 将再次尝试安装 Docker Desktop。 | |
| CTC1037 | Blazor 清单文件访问错误 | 调试 Blazor 应用程序时，重写 Blazor 静态 Web 资产文件失败。 | 有关更详细的错误信息，请参阅“输出”窗口。 |
| CTC1038 | 调试时容器不存在或未运行 | 有关容器未能启动的原因的更多详细信息，请参阅“输出”窗口。 | |
| CTC1039 | 在容器中的预期位置找不到要调试的程序的二进制文件。 | ||
| CTC1040 | 调试的程序退出时出现意外退出代码 | 无法启动应用程序进程。 请在“输出”窗口中查看更多详细信息。 | |
| CTC1041 | Docker Desktop 安装不完整。 | Docker Desktop 似乎尚未完成安装。 请尝试重新启动，如果问题仍然存在，请尝试修复 Docker Desktop 安装。 |
特定于 Docker-compose 的错误代码
| 代码 | 说明 | 注释 | Fix |
|---|---|---|---|
| DTP1001 | 找不到主机端口 | 在 Docker Compose 项目中，服务 URL 指定了令牌 {ServicePort}，但容器没有任何对应的主机端口。 |
请确保使用正确 URL 方案（http 或 https）的主机端口启动容器。 |
| DTP1002 | 未找到容器 | 调试 Docker Compose 项目时，容器未启动或容器退出。 | 有关容器未能启动的原因的更多详细信息，请参阅“输出”窗口。 |
| DTP1003 | 调试 Docker Compose 项目时找不到任何服务。 | 确保 Docker Compose 文档定义了一个或多个 dotnet 服务。 | |
| DTP1004 | Docker Compose 基架错误 | 尝试重新添加 Docker Compose 支持。 | |
| DT1001 | 运行 Docker Compose 命令时出错，导致调试失败。 | 有关此错误的更多详细信息，请参阅“输出”窗口。 | |
| DT1002 | 目标 OS 无效 | DockerDefaultTargetOS 属性中指定的 Dockerfile 目标 OS 未知。 |
支持的值为“Windows”和“Linux”。 |
| DT1003 | 尝试执行命令时出现意外错误。 | 有关此错误的更多详细信息，请参阅“输出”窗口。 | |
| DT1004 | Docker compose 文件出错 | 请检查所有 Docker Compose 文档并确保它们有效。 | |
| DT1005 | Docker Compose 命令执行失败 | 有关此错误的更多详细信息，请参阅“输出”窗口。 | |
| DT1006 | 在 Docker Compose 文档中找不到活动启动配置文件中使用的 compose 配置文件名称。 | 例如，如果活动启动配置文件使用名为 p2 的 compose 配置文件，如下所示："Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": [ "p2"]}}但 docker-compose.yml 未定义配置文件 p2，则会看到此错误。 |
更新启动配置文件以使用正确的 compose 配置文件或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1007 | 使用 compose 配置文件的活动启动配置文件中的服务名称无效。 | 例如，如果活动启动配置文件正在使用 compose 配置文件 p1 并定义 compose 配置文件 p1 的服务列表，如下所示："Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"],"serviceActions": {"webapp2": "StartWithoutDebugging"}}}但 docker-compose.yml 未定义服务 webapp2，则会看到此错误。 |
更新启动配置文件以使用正确的服务名称或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1008 | 使用 compose 配置文件的活动启动配置文件中的服务操作无效。 | 例如，如果活动启动配置文件正在使用 compose 配置文件 p1 并为服务 (webapplication) 定义了错误的操作 (wrongActionname)。"Docker Compose": { "commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"],"serviceActions": {"webapp": "wrongActionname"}}} |
请将服务操作更正为 StartWithoutDebugging，这是使用 compose 配置文件的服务的唯一有效操作。 |
| DT1009 | 活动启动配置文件同时使用 composeProfile 和 serviceActions。 |
Visual Studio 启动配置文件可以使用 compose 配置文件定义，也可以通过选择服务列表（而不使用 compose 配置文件）来定义；但不能同时使用两者来创建它。 因此，如果活动启动配置文件同时使用这两个配置文件，如下所示，则会看到此错误。"Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","composeProfile": {"includes": ["p1"]},"serviceActions": {"webapp": "StartWithoutDebugging"}} |
使用 composeProfile 或 serviceActions 或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1010 | 活动启动配置文件中的服务名称无效 | 例如，如果活动启动配置文件定义了 serviceActions，如下所示："Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","serviceActions": {"redis1": "StartWithoutDebugging","webapp8": "StartWithoutDebugging"}}但 docker-compose.yml 未定义服务 redis1，则会看到此错误。 |
更新启动配置文件以使用正确的服务名称或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1011 | 活动启动配置文件中的服务操作无效。 | 例如，如果活动启动配置文件使用了错误的服务操作 (wrongAction)，如下所示，则会看到此错误。"Docker Compose": {"commandName": "DockerCompose","commandVersion": "1.0","serviceActions": {"webapplication8": "wrongAction"}} |
将服务操作更正为 DoNotStart、StartDebugging 或 StartWithoutDebugging 之一。 或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1012 | 启动配置文件无效。 composeProfile 和 serviceActions 均缺失。 |
Visual Studio 启动配置文件可以使用 compose 配置文件定义，也可以通过选择服务列表（而不使用 compose 配置文件）来定义。 但活动启动配置文件并非使用这两者中任一项定义。 | 请使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1013 | 找不到活动启动配置文件 | 请确保在 launchSettings.json 中定义活动启动配置文件。 | |
| DT1014 | 配置文件版本无效。 | 例如，如果活动启动配置文件定义了未知的命令版本 (10.0)："Docker Compose":"commandName": "DockerCompose","commandVersion": "10.0","serviceActions": {"webapp8": "StartDebugging","redis": "StartWithoutDebugging"}} |
请查看支持的 commandVersion 的错误消息，或使用“管理 Docker Compose 启动设置”对话框更新启动设置。 |
| DT1015 | 旧配置文件版本不受支持。 | 当前 Visual Studio 不再支持此配置文件版本。 请使用“管理 Docker Compose 启动设置”对话框将配置文件升级到支持的最新版本以更新启动设置。 | |
| DT1016 | 使用的是较新版本的 Visual Studio 中的配置文件 | 此配置文件版本高于当前支持的版本。 请将 Visual Studio 升级到最新版本。 | |
| DT1017 | 使用的是较新版本的 Visual Studio 中的配置文件，但将继续工作 | 这是一条警告消息 | 配置文件版本高于当前支持的版本，但仍与当前版本的 Visual Studio 兼容，只是可能缺少一些功能。 |
| DT1018 | 使用的是旧配置文件版本，但兼容。 | 这是一条警告消息 | 配置文件版本低于最新版本，但仍兼容。 某些较新的功能可能无法正常工作。 请考虑升级到最新版本的 Visual Studio。 |
| DT1019 | compose v2 不受支持 | 你使用的是旧版本 Docker Compose v2，不支持 compose 配置文件。 | 请将 Docker Compose 升级到最新版本。 |
特定于单个项目的错误代码
| 代码 | 说明 | 注释 | Fix |
|---|---|---|---|
| CTP1001 | 未使用 | ||
| CTP1002 | 未使用 | ||
| CTP1003 | 调试时容器不存在或未运行 | 有关容器未能启动的原因的更多详细信息，请参阅“输出”窗口。 | |
| CTP1004 | Docker 基架错误 | 尝试重新添加 Docker 支持。 | |
| CTP1005 | 目标 OS 无效 | DockerDefaultTargetOS 属性中指定的 Dockerfile 目标 OS 未知。 支持的值为“Windows”和“Linux”。 |
|
| CTP1006 | 未能停止容器中的应用程序。 | 这只是一个警告。 | 请确保应用程序未在使用中。 |
| CTP1007 | 未使用 | ||
| CTP1008 | 未使用 | ||
| CTP1009 | 未能下载 Azure Functions CLI | 请在“输出”窗口中查看更多详细信息。 |