Dependência ausente de libjpeg8 no Debian 12

Atualizado:junho 9, 2026

Translated

View the article in English

No Debian 12, o IronPDF 2025.10.8 falha ao carregar sua biblioteca QPdf na inicialização porque o pacote legado libjpeg8 não está incluído no Debian 12 por padrão.

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)

O erro também pode aparecer como:

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

O Debian 12 descartou o pacote legado libjpeg8 porque foi descontinuado em 2017 e substituído por uma versão ABI mais recente. IronPDF 2025.10.8 depende de qpdf.so no diretório runtimes/linux-x64/native, que se vincula a libjpeg.so.8. Como essa biblioteca está ausente no Debian 12, o componente QPdf não pode ser carregado.

Solução

Baixe o pacote legado libjpeg8 do arquivo Debian e instale-o antes de iniciar a aplicação. Para implantações Docker, adicione estas etapas ao 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

Para ambientes Debian 12 não Docker, execute os mesmos comandos wget e apt de um shell root antes do primeiro lançamento do aplicativo. Veja o guia do IronPDF Docker para uma estrutura completa do Dockerfile.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...