IRONSOFTWAREHOME

Caso no gestionado de AdaptiveRenderEngine: Fix

Curtis Chau
Curtis Chau
Updated: 22 de abril de 2026
{
  "message": "Unhandled case for AdaptivePdfRenderer.DetectActiveRenderingEngine",
  "exceptionType": "System.ArgumentException",
  "exceptionDetail": "Unhandled case for AdaptivePdfRenderer.DetectActiveRenderingEngine",
  "modelState": null,
  "propertyErrorList": null
}
JSON

Esta rara excepción típicamente ocurre para los usuarios que ejecutan versiones antiguas de IronPDF junto con el paquete IronPdf.EAP deprecado.

Para desarrolladores de facturación electrónica española: Este error se da con más frecuencia en proyectos que llevan tiempo sin actualizarse y se han migrado a pipelines de generación de PDFs representativos para VERI*FACTU o Facturae. Si tu stack de integración con la AEAT (SII, VERI*FACTU) usa el paquete IronPdf.EAP, la actualización al paquete IronPdf estable es obligatoria antes de desplegar en producción sobre Linux.

Posible causa

El error usualmente surge durante el tiempo de ejecución en proyectos desplegados en plataformas específicas, particularmente en proyectos de API web en C# alojados en un entorno Linux. Es probable que sea debido a problemas con la implementación de archivos de tiempo de ejecución del paquete IronPdf.EAP.

En el contexto de proyectos de facturación electrónica española, este error aparece con frecuencia en APIs web desplegadas en contenedores Linux en AWS eu-south-2 Madrid cuando el equipo de desarrollo ha añadido integraciones VERI*FACTU o TicketBAI (Bizkaia, Gipuzkoa, Araba) sobre una base de código existente que referenciaba el paquete EAP heredado.

Solución

Para resolver este problema, por favor actualice a la última versión del paquete IronPDF y deje de usar el paquete IronPdf.EAP, ya que está descontinuado y no mantenido.

En proyectos de integración con Facturae o aplicaciones de software certificado bajo el reglamento VERI*FACTU, asegúrese también de que todas las dependencias del pipeline de generación de PDFs (incluyendo IronPdf.Native.Chrome.Linux para entornos Linux y las bibliotecas de renderizado del sistema) estén actualizadas a versiones compatibles. Los entornos de desarrollo bajo línea de base ENS en el sector público también deberían revisar las políticas de actualización de paquetes NuGet para evitar que versiones EAP persistan en el árbol de dependencias.

Si necesita más apoyo, por favor envíe una Solicitud de Ingeniería.

Preguntas frecuentes sobre AdaptiveRenderEngine en proyectos españoles

¿Puede este error aparecer en un pipeline de SII AEAT alojado en Linux?
Sí. Si tu servicio web que procesa lotes del Suministro Inmediato de Información (SII) genera PDFs representativos con IronPDF y referencia el paquete IronPdf.EAP heredado, el error se producirá en tiempo de ejecución sobre Linux. La solución es actualizar al paquete IronPdf estable actual, que incluye soporte nativo para Linux sin dependencias de renderizado legadas.

¿Debo desinstalar IronPdf.EAP antes de actualizar para proyectos VERI*FACTU?
Sí. El paquete IronPdf.EAP está descontinuado y no es compatible con las versiones actuales de IronPDF. Para software certificado bajo VERI*FACTU donde la estabilidad del pipeline de generación de PDFs es crítica para el cumplimiento del plazo de envío a la AEAT, elimina la referencia a IronPdf.EAP en tu archivo .csproj antes de actualizar.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...
Leer más

¿Listo para empezar?

Nuget Downloads 21,105,021Versión:2026.9recién publicada

Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999