Caso no gestionado de AdaptiveRenderEngine: Fix

Actualizado:19 de mayo de 2026

Translated

View the article in English

{
  "message": "Unhandled case for AdaptivePdfRenderer.DetectActiveRenderingEngine",
  "exceptionType": "System.ArgumentException",
  "exceptionDetail": "Unhandled case for AdaptivePdfRenderer.DetectActiveRenderingEngine",
  "modelState": null,
  "propertyErrorList": null
}

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 VERIFACTU?*
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

Chatea con el equipo de ingeniería ahora

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 ...

¿Listo para empezar?

Nuget Descargas 19,014,616 | Versión: 2026.5 just released