Dependencias faltantes en el despliegue de IronPDF Lambda

Actualizado:9 de junio de 2026

Translated

View the article in English

IronPDF no se inicia cuando se despliega en AWS Lambda, produciendo errores similares a:

IronPDF failed to start: required native binaries not found at the expected path.
Unable to load shared library or one of its dependencies.
Error: Required IronPDF native dependencies were not found in the deployment package.

Las dependencias nativas faltantes en los despliegues de Lambda son causadas por uno o más de los siguientes:

Permisos faltantes: el rol de ejecución Lambda o la ruta del sistema de archivos no tienen los permisos de Lectura/Escritura/Ejecución requeridos por IronPDF.
Binarios nativos ausentes: las bibliotecas nativas de IronPDF no fueron incluidas en el paquete de despliegue.
Dockerfile incorrecto: el Dockerfile no instala las dependencias correctas a nivel del sistema operativo para la imagen base de Lambda.

Solución

Cambie al paquete NuGet IronPdf.Slim. A diferencia del paquete completo de IronPDF, IronPdf.Slim descarga automáticamente los binarios nativos correctos para la imagen base detectada en tiempo de ejecución, eliminando la necesidad de incluir manualmente binarios específicos de la plataforma:

// NuGet: IronPdf.Slim
// IronPdf.Slim selects and downloads the appropriate native runtime
// for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>");
pdf.SaveAs("/tmp/output.pdf");

// NuGet: IronPdf.Slim
// IronPdf.Slim selects and downloads the appropriate native runtime
// for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>");
pdf.SaveAs("/tmp/output.pdf");

' NuGet: IronPdf.Slim
' IronPdf.Slim selects and downloads the appropriate native runtime
' for the Lambda execution environment automatically.
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from Lambda</h1>")
pdf.SaveAs("/tmp/output.pdf")

$vbLabelText $csharpLabel

Prueba directamente en Lambda: no dependas de las pruebas locales para verificar la resolución de dependencias nativas. Ejecutar el proyecto localmente descarga binarios compatibles con Windows o el sistema operativo anfitrión en lugar de los compatibles con Lambda, produciendo un pase falso.

Recuperar archivos de registro de AWS para obtener detalles de diagnóstico cuando el problema persiste después de cambiar a IronPdf.Slim. Habilita el registro antes de la primera llamada a IronPDF:

IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "/tmp/ironpdf.log";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "/tmp/ironpdf.log";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

Imports IronPdf.Logging

Logger.EnableDebugging = True
Logger.LogFilePath = "/tmp/ironpdf.log"
Logger.LoggingMode = Logger.LoggingModes.All

$vbLabelText $csharpLabel

Adjunte /tmp/ironpdf.log y la salida de registro de CloudWatch de Lambda a su solicitud de soporte. Vea también: desplegar IronPDF en AWS Lambda con Docker y cómo obtener archivos de registro de IronPDF en AWS.

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 20,088,359 | Versión: 2026.7 recién publicada