.NET Core 2.1 Service Fabric Mesh应用Windows容器gdiplus.dll加载失败解决

你遇到的这个错误核心原因很明确：System.Drawing.Common依赖Windows系统的GDI+组件，但你使用的microsoft/dotnet:2.1-aspnetcore-runtime基础镜像是基于Windows Server Core构建的——这是一个精简版的Windows环境，默认移除了GDI+这类桌面相关的组件，所以运行时会找不到gdiplus.dll。

下面给你两种可行的解决方案，你可以根据自身需求选择：

方案一：在容器中补装GDI+依赖组件 #

你可以在Dockerfile的final阶段添加PowerShell命令，安装Windows Server Core缺失的GDI+相关组件。修改后的Dockerfile如下：

FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base
WORKDIR /app
EXPOSE 80

FROM microsoft/dotnet:2.1-sdk AS build
WORKDIR /src
COPY MS_Upload/MS_Upload.csproj MS_Upload/
RUN dotnet restore MS_Upload/MS_Upload.csproj
COPY . .
WORKDIR /src/MS_Upload
RUN dotnet build MS_Upload.csproj -c Release -o /app

FROM build AS publish
RUN dotnet publish MS_Upload.csproj -c Release -o /app

FROM base AS final
WORKDIR /app
# 新增步骤：安装GDI+依赖的Windows组件
RUN powershell -Command \
    Install-WindowsFeature -Name Server-Gui-Mgmt-Infra, Server-Gui-Shell; \
    Install-WindowsFeature -Name Desktop-Experience
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "MS_Upload.dll"]

⚠️ 注意：这种方法会显著增大容器镜像体积（因为安装了桌面相关组件），如果你的场景对镜像大小有严格要求，更推荐第二种方案。

方案二：替换为跨平台图形处理库 #

System.Drawing.Common本质是Windows专属库，在容器环境尤其是后续.NET版本中兼容性会越来越差（比如.NET 6及以后，即使在Windows容器中也默认禁用了它）。更长远的解决方案是改用跨平台的图形处理库，比如：

• ImageSharp：纯C#实现的轻量级跨平台图像库，无系统组件依赖
• SkiaSharp：Google Skia图形引擎的.NET绑定，支持多平台

以ImageSharp为例，操作步骤很简单：

1. 移除项目中对System.Drawing.Common的引用
2. 安装NuGet包SixLabors.ImageSharp
3. 修改图像处理代码，替换原有的Bitmap相关逻辑：

using SixLabors.ImageSharp;

// 替换原来的Bitmap构造代码
using var image = Image.Load(stream);
// 后续的图像操作API与System.Drawing类似，学习成本低

这种方法不仅能解决当前容器中的问题，还能让你的应用具备更好的跨平台扩展性。

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