在Debian 12上缺少libjpeg8依赖项

Updated: 2026年6月10日

在Debian 12上，IronPDF 2025.10.8在启动时无法加载其QPdf库，因为默认情况下Debian 12中未包含旧版libjpeg8软件包。

IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying QPdf for IronPdf: 'Multiple issues occurred while trying to deploy QPdf (libjpeg.so.8: cannot open shared object file: No such file or directory)

IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying QPdf for IronPdf: 'Multiple issues occurred while trying to deploy QPdf (libjpeg.so.8: cannot open shared object file: No such file or directory)

Text

错误也可能显示为：

Error while loading '/path/to/runtimes/linux-x64/native/qpdf.so' via libdl2 : '/lib/x86_64-linux-gnu/libjpeg.so.8: version `LIBJPEG_8.0' not found

Error while loading '/path/to/runtimes/linux-x64/native/qpdf.so' via libdl2 : '/lib/x86_64-linux-gnu/libjpeg.so.8: version `LIBJPEG_8.0' not found

Text

Debian 12删除了旧版libjpeg8软件包，因为它在2017年被弃用，并被更新的ABI版本取代。 IronPDF 2025.10.8 依赖于 runtimes/linux-x64/native 目录中的libjpeg.so.8。由于该库在Debian 12上缺失，QPdf组件无法加载。

解决方案

从Debian档案中下载旧版本libjpeg8软件包并在启动应用程序之前安装。对于Docker部署，将这些步骤添加到Dockerfile中：

FROM mcr.microsoft.com/dotnet/runtime:8.0 AS base
USER root
WORKDIR /app

RUN apt update && apt install -y sudo wget
RUN wget https://archive.debian.org/debian/pool/main/libj/libjpeg8/libjpeg8_8b-1_amd64.deb
RUN apt install -y ./libjpeg8_8b-1_amd64.deb

FROM mcr.microsoft.com/dotnet/runtime:8.0 AS base
USER root
WORKDIR /app

RUN apt update && apt install -y sudo wget
RUN wget https://archive.debian.org/debian/pool/main/libj/libjpeg8/libjpeg8_8b-1_amd64.deb
RUN apt install -y ./libjpeg8_8b-1_amd64.deb

Text

对于非Docker Debian 12环境，从root shell运行相同的wget和apt命令，然后启动应用程序。有关完整的Dockerfile结构，请参阅IronPDF Docker指南。