Share via

容器工具錯誤訊息

  • 發行項

本文列出 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。 請檢查網際網路連線。
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)。 檢查您的網際網路連線，且沒有防火牆封鎖檔案下載。
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 Scaffolding 錯誤 再次嘗試新增 Docker Compose 支援。
DT1001 由於執行 Docker Compose 命令時發生錯誤，所以偵錯失敗。 如需更多關於此錯誤的詳細資料，請查看 [輸出] 視窗。
DT1002 無效的目標 OS DockerDefaultTargetOS 屬性中所指定的未知 Dockerfile 目標 OS。 支援的值為 'Windows' 和 'Linux'。
DT1003 嘗試執行命令時，發生未預期的錯誤。 如需更多關於此錯誤的詳細資料，請查看 [輸出] 視窗。
DT1004 Docker Compose 檔案中的錯誤 檢查所有 Docker Compose 文件，並確定文件有效。
DT1005 Docker Compose 命令執行失敗 如需更多關於此錯誤的詳細資料，請查看 [輸出] 視窗。
DT1006 在 Docker Compose 文件中找不到作用中啟動設定檔中使用的撰寫設定檔名稱。 例如，如果作用中啟動設定檔使用名為 p2 的撰寫設定檔，如下所示：

"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
        "p2"
    ]
  }
}

但 docker-compose.yml 未定義設定檔 p2，則您會看到此錯誤。		 更新啟動設定檔以使用正確的撰寫設定檔，或使用 [管理 Docker Compose 啟動設定] 對話方塊來更新啟動設定。
DT1007 使用撰寫設定檔的作用中啟動設定檔中的服務名稱無效。 例如，如果作用中啟動設定檔使用撰寫設定檔 p1，並定義撰寫設定檔 p1 的服務清單，如下所示：

"Docker Compose": {
  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
      "p1"
    ],
    "serviceActions": {
      "webapp2": "StartWithoutDebugging"
    }
  }
}
但 docker-compose.yml 未定義服務 webapp2，則您會看到此錯誤。		 更新啟動設定檔以使用正確的服務名稱，或使用 [管理 Docker Compose 啟動設定] 對話方塊來更新啟動設定。
DT1008 使用撰寫設定檔的作用中啟動設定檔中的服務動作無效。 例如，如果作用中啟動設定檔使用撰寫設定檔 p1，並針對服務 (webapplication) 定義錯誤動作 (wrongActionname)。
"Docker Compose": {  "commandName": "DockerCompose",
  "commandVersion": "1.0",
  "composeProfile": {
    "includes": [
      "p1"
    ],
    "serviceActions": {
      "webapp": "wrongActionname"
    }
  }
}
 將服務動作更正為 StartWithoutDebugging，這是使用撰寫設定檔服務的唯一有效動作。
DT1009 作用中啟動設定檔正同時使用 composeProfile 和 serviceActions。 您可以使用撰寫設定檔或挑選並選擇服務清單，而不使用撰寫設定檔來定義 Visual Studio 啟動設定檔；無法使用這兩者來建立。 因此，如果作用中的啟動設定檔使用兩者，如下所示，則您會看到此錯誤。
"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 啟動設定檔。 但作用中的啟動設定檔未定義其中任何一個。 使用 [管理 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 不支援的撰寫 v2 您使用的是不支援撰寫設定檔的舊版 Docker Compose v2。 將 Docker Compose 升級至最新版本。

單一專案特定的錯誤碼

代碼 描述 附註 Fix
CTP1001 未使用
CTP1002 未使用
CTP1003 容器在偵錯時不存在或未執行 如需容器無法啟動原因的詳細資料，請參閱 [輸出] 視窗。
CTP1004 Docker Scaffolding 錯誤 再次嘗試新增 Docker 支援。
CTP1005 無效的目標 OS DockerDefaultTargetOS 屬性中所指定的未知 Dockerfile 目標 OS。 支援的值為 'Windows' 和 'Linux'。
CTP1006 無法停止容器內的應用程式。 這只是一個警告。 請確定應用程式未使用中。
CTP1007 未使用
CTP1008 未使用
CTP1009 無法下載 Azure Functions CLI 如需更多詳細資料，請查看 [輸出] 視窗。