Docker中使用.NET Framework 4.8 SDK构建4.5版本项目失败求助

两次报错的核心原因 #

• 第一次使用FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build报错：该镜像为.NET Core/.NET 5及以上版本的跨平台SDK镜像，完全不兼容.NET Framework 4.x系列的项目构建需求，属于基础镜像与项目框架类型不匹配。
• 更换为FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build后仍报错，常见触发原因有两个：
  1. Docker运行环境模式错误：.NET Framework的所有Docker镜像仅支持在Windows容器环境下运行，若你的Docker当前处于Linux容器模式，无论使用什么版本的.NET Framework镜像都会触发构建失败，这是Docker新手最容易忽略的配置问题。
  2. 目标框架版本不匹配：你的项目目标框架为.NET Framework 4.5，4.8版本的SDK镜像虽然理论上向下兼容，但默认配置下可能缺失4.5版本的引用程序集，导致构建时找不到对应依赖。

可直接落地的解决步骤 #

1. 切换Docker运行模式
   打开Docker Desktop的托盘菜单，确认已切换为「使用Windows容器」，完成切换后等待Docker重启完毕再进行后续操作。
2. 调整基础镜像配置
   推荐优先选择与项目框架完全匹配的镜像，将Dockerfile中的基础镜像指令修改为：
   FROM mcr.microsoft.com/dotnet/framework/sdk:4.5 AS build
   该镜像内置了.NET Framework 4.5的全部构建依赖，无需额外调整项目配置即可直接使用。
   若你因特殊需求必须使用4.8版本的SDK镜像，可在构建指令中添加/p:TargetFrameworkVersion=v4.5参数，指定构建时的目标框架版本即可。
3. 重新执行构建命令
   上述配置调整完成后，重新运行docker build命令即可正常完成项目构建。

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