.NET 6更新后Docker容器部署框架缺失报错，如何解决预防？

每次.NET 6框架发布更新时，更新Docker容器都会遇到如下报错：

Framework: 'Microsoft.NETCore.App', version '6.0.12' (x64)
.NET location: /usr/share/dotnet/
The following frameworks were found:
6.0.11 at [/usr/share/dotnet/shared/Microsoft.NETCore.App]
Learn about framework resolution:
https://aka.ms/dotnet/app-launch-failed
To install missing framework, download:
https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=6.0.12&arch=x64&rid=debian.11-x64

仅对代码做了微小修改，未新增或更新依赖，重新部署服务时出现该问题，且问题次日会自动消失。补充说明：原本以为在本地安装最新版运行时可解决问题，但在.NET 6.0.14版本时该错误再次出现，更新本地运行时也无法解决。

使用的Dockerfile内容如下：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["src/Services/Orders/KapSys.Orders.Sync/KapSys.Orders.Sync.csproj", "src/Services/Orders/KapSys.Orders.Sync/"]
RUN dotnet restore "src/Services/Orders/KapSys.Orders.Sync/KapSys.Orders.Sync.csproj"
COPY . .
WORKDIR "/src/src/Services/Orders/KapSys.Orders.Sync"
RUN dotnet build "KapSys.Orders.Sync.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "KapSys.Orders.Sync.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "KapSys.Orders.Sync.dll"]

核心原因 #

问题根源在于mcr.microsoft.com/dotnet/aspnet:6.0和sdk:6.0是滚动更新的浮动标签：当.NET 6发布新补丁版本时，SDK镜像会率先更新到最新版本，导致构建出的应用依赖新版本运行时；但ASP.NET基础镜像的更新存在时间差，此时基础镜像中仍为旧版本运行时，从而触发版本不匹配报错。次日镜像同步完成后，问题自动消失。

解决&预防方法 #

1. 使用固定补丁版本的镜像标签 #

放弃6.0这类浮动标签，改用具体补丁版本的标签，确保SDK和ASP.NET基础镜像的版本完全一致：

# 示例：指定为6.0.12版本，需根据实际需求替换
FROM mcr.microsoft.com/dotnet/aspnet:6.0.12 AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:6.0.12 AS build
# 后续构建步骤保持不变

这种方式从根源上保证构建与运行环境的.NET版本一致，彻底避免版本不兼容问题。

2. 配置全局.NET版本锁定 #

在项目根目录创建global.json文件，指定固定的.NET SDK版本，确保本地构建与Docker构建使用相同版本：

{
  "sdk": {
    "version": "6.0.404" // 对应.NET 6.0.12运行时的SDK版本，需按需匹配
  }
}

将该文件纳入Docker构建上下文，确保dotnet restore和dotnet build过程严格遵循指定版本。

3. 采用自包含部署模式 #

在dotnet publish命令中添加--self-contained true参数，将应用与所需的.NET运行时打包在一起，完全脱离基础镜像的运行时依赖：

FROM build AS publish
RUN dotnet publish "KapSys.Orders.Sync.csproj" -c Release -o /app/publish --self-contained true --runtime debian.11-x64

此方法会增大镜像体积，但彻底消除运行时版本匹配问题。

4. 延迟构建（临时缓解） #

若暂时无法修改镜像配置，可在.NET新版本发布后等待1-2天，待ASP.NET基础镜像完成同步后再执行构建部署，但这仅为临时方案，无法从根本解决问题。

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