在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命令。請參閱IronPDF Docker指南以獲得完整的Dockerfile結構。