Docker构建.NET WebAPI时SDK版本不匹配错误求助

问题描述 #

通过dotnet new webapi生成WebAPI项目并添加Dockerfile后，执行docker build -t pregrad/weatherapi .构建镜像时出现以下错误：

[+] Building 1.1s (13/14)
 => [internal] load build definition from Dockerfile                                                                                                                                                                0.0s 
 => => transferring dockerfile: 32B                                                                                                                                                                                 0.0s 
 => [internal] load .dockerignore                                                                                                                                                                                   0.0s 
 => => transferring context: 2B                                                                                                                                                                                     0.0s 
 => [internal] load metadata for mcr.microsoft.com/dotnet/core/aspnet:3.1                                                                                                                                           0.4s 
 => [internal] load metadata for mcr.microsoft.com/dotnet/core/sdk:3.1                                                                                                                                              0.4s 
 => [stage-1 1/3] FROM mcr.microsoft.com/dotnet/core/aspnet:3.1@sha256:1830f7a5dbe41cc341235072f9b1c2de7163a4c89b505a4a31a5fbe3b281539e                                                                             0.0s 
 => [build-env 1/6] FROM mcr.microsoft.com/dotnet/core/sdk:3.1@sha256:53a7a7d70ac0473e9e06ccd8a4992160b58952c3dbdd91ef3e6c28dc5760ed6f                                                                              0.0s 
 => [internal] load build context                                                                                                                                                                                   0.0s 
 => => transferring context: 1.61kB                                                                                                                                                                                 0.0s 
 => CACHED [stage-1 2/3] WORKDIR /app                                                                                                                                                                               0.0s 
 => CACHED [build-env 2/6] WORKDIR /app                                                                                                                                                                             0.0s 
 => CACHED [build-env 3/6] COPY *.csproj ./                                                                                                                                                                         0.0s 
 => CACHED [build-env 4/6] RUN dotnet restore                                                                                                                                                                       0.0s 
 => [build-env 5/6] COPY . ./                                                                                                                                                                                       0.1s 
 => ERROR [build-env 6/6] RUN dotnet publish -c Release -o out                                                                                                                                                      0.4s 
------
 > [build-env 6/6] RUN dotnet publish -c Release -o out:
#13 0.381 未找到与/app/global.json中[6.0.402]版本兼容的已安装.NET Core SDK
#13 0.381 请安装[6.0.402]版本的.NET Core SDK，或更新/app/global.json以匹配已安装的SDK：
#13 0.381   3.1.424 [/usr/share/dotnet/sdk]
------
executor failed running [/bin/sh -c dotnet publish -c Release -o out]: exit code: 145

本地执行dotnet --list-sdks显示已安装版本：

3.1.424 [C:\Program Files\dotnet\sdk]
5.0.100 [C:\Program Files\dotnet\sdk]
6.0.402 [C:\Program Files\dotnet\sdk]

解决方案 #

方法一：修改Dockerfile使用匹配的SDK镜像 #

Docker构建环境使用的是.NET Core 3.1 SDK镜像，但项目global.json指定了6.0.402版本，导致容器内SDK版本不匹配。需将Dockerfile中的镜像替换为.NET 6版本：

1. 打开项目中的Dockerfile，找到以下两行：

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build-env
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1

2. 替换为.NET 6的官方镜像（注意：.NET 5及以后版本镜像路径不再包含core前缀）：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build-env
FROM mcr.microsoft.com/dotnet/aspnet:6.0

3. 重新执行构建命令：

docker build -t pregrad/weatherapi .

方法二：修改global.json适配Docker中的SDK版本 #

若需继续使用.NET 3.1的Docker镜像，可调整项目global.json指定容器内已安装的3.1.424版本：

1. 打开项目根目录下的global.json文件，修改sdk.version字段：

{
  "sdk": {
    "version": "3.1.424"
  }
}

2. 保存文件后重新执行Docker构建命令。

额外说明 #

• Docker构建在独立容器环境中进行，容器内SDK版本由镜像决定，与本地环境无关。
• 建议保持Docker镜像的SDK版本与项目实际使用的.NET版本一致，避免兼容问题。

内容的提问来源于stack exchange，提问作者predrag