MacBook下.NET Core项目WkHtmlToPdf-DotNet Docker容器libgdiplus.so缺失问题解决

问题根源 #

Debian不同版本（如Bookworm、Buster）的libgdiplus安装路径存在差异，官方文档里写死的/usr/lib/libgdiplus.so路径在新版本镜像里可能不存在，导致软链接创建失败。

具体解决方法 #

1. 确保依赖安装完整

先执行完整的依赖安装命令，不要漏掉更新源和必要的依赖包：

RUN apt-get update && apt-get install -y --no-install-recommends \
    libgdiplus \
    libc6-dev \
    wkhtmltopdf \
    && rm -rf /var/lib/apt/lists/*

--no-install-recommends可以减少镜像体积，libc6-dev是libgdiplus依赖的编译库，必须安装。

2. 动态查找文件路径创建软链接

不要写死路径，用命令动态定位libgdiplus.so的实际位置：

RUN ln -s $(find / -name libgdiplus.so 2>/dev/null | head -1) /lib/x86_64-linux-gnu/libgdiplus.so || true

|| true可以避免找不到文件时Docker构建失败，适合兼容性场景。

3. 替代方案：设置环境变量（无需软链接）

如果不需要创建软链接，直接通过环境变量让系统找到库文件：

ENV LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH

大多数Debian新版本的libgdiplus默认安装在/usr/lib/x86_64-linux-gnu目录，设置这个环境变量后，.NET程序就能直接找到库。

完整Dockerfile片段示例 #

FROM mcr.microsoft.com/dotnet/aspnet:8.0-bookworm-slim AS base

# 安装依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libgdiplus \
    libc6-dev \
    wkhtmltopdf \
    && rm -rf /var/lib/apt/lists/*

# 动态创建软链接（或用上面的环境变量方案）
RUN ln -s $(find / -name libgdiplus.so 2>/dev/null | head -1) /lib/x86_64-linux-gnu/libgdiplus.so || true

WORKDIR /app
EXPOSE 8080

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