Docker容器启动失败：找不到.NET框架Microsoft.WindowsDesktop.App 7.0.0

问题描述 #

使用Visual Studio 2022创建的API应用，发布到文件夹后构建Docker镜像无异常，但容器启动失败，报错如下：

You must install or update .NET to run this application.

App: C:\app\SyntaxBuilder.dll

Architecture: x64
Framework: 'Microsoft.WindowsDesktop.App', version '7.0.0' (x64)
.NET location: C:\Program Files\dotnet
No frameworks were found.

对应的Dockerfile内容：

FROM mcr.microsoft.com/dotnet/aspnet

COPY ["./SyntaxBuilder/bin/Release/net7-windows/publish/","/app"]

WORKDIR /app

ENTRYPOINT ["dotnet", "SyntaxBuilder.dll"]

核心原因 #

1. 基础镜像不匹配：默认的mcr.microsoft.com/dotnet/aspnet是Linux版本镜像，但你的应用发布目标为net7-windows（Windows专属框架），且依赖仅Windows平台提供的Microsoft.WindowsDesktop.App（桌面应用框架，多用于WPF/WinForms），Linux镜像中不存在该框架，导致启动失败。
2. 项目依赖冗余：API项目通常不需要依赖Microsoft.WindowsDesktop.App，大概率是项目中误引用了桌面相关的NuGet包或组件。

解决方案 #

方案一：使用Windows版本的.NET基础镜像 #

修改Dockerfile的基础镜像为对应版本的Windows Server Core镜像，保证框架环境匹配：

# 选择与net7-windows匹配的Windows基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:7.0-windowsservercore-ltsc2022

COPY ["./SyntaxBuilder/bin/Release/net7-windows/publish/","/app"]

WORKDIR /app

ENTRYPOINT ["dotnet", "SyntaxBuilder.dll"]

注意：Windows镜像体积远大于Linux镜像，仅在必须依赖Windows特性时使用。

方案二：移除不必要的Windows桌面依赖（推荐） #

1. 打开Visual Studio项目，检查并移除所有与WPF、WinForms或Microsoft.WindowsDesktop.App相关的NuGet包和引用。
2. 修改项目的目标框架为跨平台的net7.0（而非net7-windows），重新执行发布操作。
3. 保留原Dockerfile不变（使用Linux版aspnet镜像），重新构建并启动容器。

方案三：采用自包含发布模式（适用于必须依赖Windows特性的场景） #

如果确实需要Windows平台特性，可使用自包含发布模式将框架一并打包：

• 发布命令示例：

dotnet publish -c Release -r win-x64 --self-contained true

修改Dockerfile中对应的发布路径后，搭配Windows基础镜像启动容器。

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