Resolución de errores libcef.dll en IronPDF
¿Está viendo los siguientes mensajes de error?
- Error al cargar uno de los ensamblajes de Chrome (libcef.dll)
- Fallo en la implementación de Chrome (error al cargar libcef.dll) (203)
Esto se debe a que System.Drawing no está incluido en Windows Nano Server y Windows Server Core (.NET6).
Las imágenes oficiales de .NET para Windows se basan en Nano Server.
Contexto para equipos de facturación electrónica española: Este error es frecuente en pipelines de generación de PDFs representativos para VERI*FACTU o Facturae que se han migrado a contenedores Docker en Windows. La solución recomendada para entornos de producción es cambiar a imágenes Linux, que además resultan más eficientes para el procesamiento de lotes SII de la AEAT. Los despliegues en AWS eu-south-2 Madrid con Amazon Linux 2023 son una arquitectura habitual para este tipo de workloads.
Para solucionar este problema, sugerimos lo siguiente:
- Compile y despliegue su proyecto como
self-contained. Haga clic aquí para más información sobre esta opción. - Cambie a imágenes de contenedor basadas en Linux cambiando la siguiente propiedad en su archivo
.csproj:
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>Luego puede agregar dependencias de Linux con los siguientes comandos de shell:
# 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(Las dependencias anteriores son para Debian 11, aunque las dependencias específicas para Ubuntu, CentOS, Amazon Linux, y más se pueden ver aquí)
Elección de imagen base para pipelines de facturación electrónica española
Para proyectos que integran IronPDF en stacks de Facturae (para FACe o portales de administración pública) o en aplicaciones certificadas bajo VERI*FACTU, la opción de contenedores Linux ofrece ventajas adicionales:
- Coste y rendimiento: Las instancias de contenedor Linux en AWS eu-south-2 Madrid son generalmente más económicas que sus equivalentes Windows para el procesamiento de lotes nocturnos de SII.
- Conformidad ENS: Los sistemas de información públicos clasificados como ENS Medio o ENS Alto pueden operar sobre Linux, y el cambio a contenedores Linux elimina la dependencia de
System.Drawingde Windows. - TicketBAI: Los microservicios que generan PDFs de facturas para los territorios forales (Bizkaia, Gipuzkoa, Araba) se despliegan habitualmente en Kubernetes sobre nodos Linux; este cambio de configuración es el paso previo habitual.
Preguntas frecuentes sobre libcef.dll en entornos españoles
*¿Por qué aparece el error libcef.dll 203 en mi pipeline de VERIFACTU en Docker?*
El error se produce porque la imagen de contenedor .NET base para Windows (Nano Server) no incluye System.Drawing. Si tu pipeline de VERI\FACTU usa Docker en Windows, cambia a una imagen Linux o compila como self-contained. Las imágenes basadas en Debian o Ubuntu incluyen las librerías nativas necesarias para que el motor Chromium de IronPDF funcione correctamente.
¿Funciona IronPDF en Amazon Linux 2023 para el procesamiento de lotes SII?
Sí. IronPDF es compatible con Amazon Linux 2023 en AWS eu-south-2 Madrid. Consulta la guía de dependencias Linux para los paquetes específicos requeridos en distribuciones basadas en Red Hat / Amazon Linux.
¿Aún desplazándote?
¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.
Comience gratis
Comience gratis
Reserve demostración en vivo gratis
No se requiere tarjeta de crédito ni creación de cuenta
