.NET Core在Docker Linux中用System.Drawing.Common遇‘无法打开显示’错误求助

这个问题的核心原因是你调用的Graphics.FromHwnd(IntPtr.Zero)依赖X11显示服务器——它需要绑定到一个实际的窗口句柄，但Docker容器默认没有运行X Server，也未配置对应的DISPLAY环境变量，所以才会抛出这个异常。

下面分两种场景给出针对性解决方案：

场景1：你不需要渲染到窗口（仅离线生成图片/绘图） #

这是无UI环境下最常见的场景，完全不需要依赖X Server，你应该放弃使用FromHwnd，改用基于Bitmap的绘图方式，这才是.NET Core在无桌面环境下正确的绘图姿势：

// 示例：创建Bitmap并获取Graphics对象执行离线绘图
using (var bitmap = new Bitmap(800, 600))
{
    using (var graphics = Graphics.FromImage(bitmap))
    {
        // 在这里编写你的绘图逻辑，比如绘制文字、图形
        graphics.Clear(Color.White);
        using (var font = new Font("Arial", 12))
        {
            graphics.DrawString("Hello Linux!", font, Brushes.Black, new PointF(10, 10));
        }
        // 将结果保存到文件或流
        bitmap.Save("output.png", ImageFormat.Png);
    }
}

这种方式完全不依赖X11，只要容器内安装了libgdiplus就能正常运行，无需额外的X Server配置。

场景2：你确实需要绑定窗口句柄（必须依赖X Server） #

如果业务逻辑必须使用FromHwnd（比如要渲染到特定窗口），那你需要在Docker容器中运行一个虚拟X Server，常用工具是Xvfb（虚拟帧缓冲X Server）。

修改Dockerfile安装Xvfb： #

FROM microsoft/aspnetcore
ENV DOTNET_SKIP_FIRST_TIME_EXPERIENCE true
# 安装libgdiplus、X11依赖及Xvfb
RUN apt-get update && \
    apt-get install -y --allow-unauthenticated libgdiplus libc6-dev libx11-dev xvfb

通过Xvfb启动应用： #

你可以用xvfb-run自动启动虚拟X Server并配置DISPLAY变量：

xvfb-run -a dotnet your-app.dll

也可以手动启动Xvfb并设置环境变量：

# 启动虚拟X Server，指定显示编号为0、分辨率1024x768、16位色深
Xvfb :0 -screen 0 1024x768x16 &
# 设置DISPLAY环境变量指向虚拟显示
export DISPLAY=:0
# 运行你的.NET应用
dotnet your-app.dll

额外提醒 #

System.Drawing.Common在Linux上基于libgdiplus实现，libgdiplus对X11的依赖仅针对窗口相关操作。如果你的场景只是离线生成图片，一定要用Graphics.FromImage而非依赖窗口句柄的方法，这样能避免大量不必要的环境配置问题。

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