Docker运行ASP.NET Core 3.1应用报错：找不到Microsoft.WindowsDesktop.App 3.1.0

你的Web项目本身确实没有直接引用Microsoft.WindowsDesktop.App，但Docker运行时仍抛出这个错误，大概率是你引入的OtherLibsProjects类库中存在隐性依赖，或者打包过程中误引入了Windows专属组件。下面是具体的排查和解决步骤：

1. 检查引用的类库项目 #

打开OtherLibsProjects下的所有.csproj文件，排查是否存在以下内容：

• 直接声明的框架引用：<FrameworkReference Include="Microsoft.WindowsDesktop.App" />
• 依赖WPF、WinForms等Windows桌面相关的NuGet包

如果找到这类引用，要么移除不必要的Windows依赖（毕竟你用的是Linux容器），要么如果确实需要相关功能，就得切换到Windows容器镜像（但显然这不是你的首选）。

2. 优化Dockerfile中的publish命令 #

在publish阶段，明确指定与基础镜像匹配的Linux运行时，避免打包不必要的组件：

RUN dotnet publish "Web.App.csproj" -c Release -o /app/publish -r debian.10-x64 --self-contained false

参数说明：

• -r debian.10-x64：指定目标运行时为Debian 10 x64，和你使用的aspnet:3.1-buster-slim镜像完全匹配
• --self-contained false：告诉SDK不要打包完整运行时，而是复用基础镜像中的ASP.NET Core运行时，避免引入Windows相关组件

3. 调整Web项目的托管模型 #

你的Web.App.csproj中设置了<AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel>，这个模式是针对Windows IIS的，在Linux容器（默认用Kestrel作为服务器）下应该改为OutOfProcess：

<AspNetCoreHostingModel>OutOfProcess</AspNetCoreHostingModel>

也可以直接删除这个配置项，因为ASP.NET Core默认就是OutOfProcess模式。

4. 验证依赖链（可选） #

如果以上步骤没解决问题，本地执行publish后，检查输出目录的Web.App.deps.json文件，搜索Microsoft.WindowsDesktop.App。如果能找到相关条目，用以下命令排查传递依赖的根源：

dotnet list Web.App.csproj package --include-transitive

按上述步骤调整后，重新构建Docker镜像应该就能解决这个框架找不到的问题了。

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