通过

容器工具错误消息

  • 项目

本文列出了 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 请在“输出”窗口中查看更多详细信息。