解决 IronPDF 中的 libcef.dll 错误

Curtis Chau

Updated: 2026年4月22日

您是否看到以下错误信息？

加载其中一个 Chrome 程序集 (libcef.dll) 时出错
Chrome 部署失败（加载 libcef.dll 时出错）(203)

这是因为 System.Drawing 未包含在 Windows Nano Server 和 Windows Server Core (.NET6) 中。

Windows 平台的官方 .NET 镜像基于 Nano Server。

为解决此问题，我们建议采取以下任一方案：

按 self-contained 的方式构建并部署您的项目。点击此处了解此选项的更多信息。
通过修改 .csproj 文件中的以下属性，切换至基于 Linux 的容器镜像：

<!-- Change the default OS for Docker to Linux to use Linux-based images -->
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>

<!-- Change the default OS for Docker to Linux to use Linux-based images -->
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>

XML

随后，您可以使用以下 shell 命令添加 Linux 依赖项：

# Update package lists and install necessary libraries for IronPDF on Linux
RUN apt update \
    && apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 \
    libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1

# Update package lists and install necessary libraries for IronPDF on Linux
RUN apt update \
    && apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 \
    libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1

SHELL

（上述依赖项适用于 Debian 11，但 Ubuntu、CentOS、Amazon Linux 等系统的具体依赖项可在此处查看）