IronPDFのLambdaデプロイメントでの依存関係の欠落

Updated: 2026年6月10日

IronPDFがAWS Lambdaにデプロイされるときに初期化に失敗し、次のようなエラーを生成します：

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.

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.

Text

Lambdaデプロイメントでの欠落しているネイティブ依存は、次のいずれかまたは複数の原因によって引き起こされます：

権限の不足： Lambda実行用のロールまたはファイルシステムパスがIronPDFによって要求される読み取り/書き込み/実行権限を欠いています。
ネイティブバイナリが欠如しています: ネイティブIronPDFライブラリが展開パッケージに含まれていませんでした。
誤ったDockerfile: DockerfileがLambdaベースイメージの適切なOSレベルの依存関係をインストールしていません。

解決策

NuGetパッケージIronPdf.Slimに切り替えてください。完全なIronPDFパッケージとは異なり、IronPdf.Slimはランタイム時に検出された基本イメージの正しいネイティブバイナリを自動的にダウンロードするため、プラットフォーム固有のバイナリを手動でバンドルする必要がなくなります：

// 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")

' 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")

Lambdaで直接テストする: ネイティブ依存関係の解決を確認するためにローカルテストに依頼しないでください。プロジェクトをローカルで実行すると、Lambda互換ではなく、Windows互換またはホストOS互換のバイナリがダウンロードされ、誤った合格を生じます。

ログファイルを取得して、IronPdf.Slimに切り替えた後も問題が続く場合は、AWSから診断の詳細を確認してください。最初の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

Imports IronPdf.Logging

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

/tmp/ironpdf.logとLambda CloudWatchのログ出力をサポートリクエストに添付してください。関連リンクも参照してください：AWS LambdaにDockerでIronPDFをデプロイするとAWSでIronPDFのログファイルを取得する方法。

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む