容器工具錯誤訊息
本文列出 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 | 如需更多詳細資料,請查看 [輸出] 視窗。 |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應