IronPDF NestJS TypeScript ビルドエラー
IronPDF Node.js SDK を NestJS プロジェクトに追加すると、TypeScript がコンパイル時に失敗します。
Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'.IronPDF SDK 内の Zod スキーマ宣言 (pageSchema.ts) は、NestJS TypeScript ビルドで期待されるオブジェクトの形状に一致しない型を定義しています。 NestJS は、通常の Node.js プロジェクトよりも厳格なモジュール解決を強制しており、これによりコンパイル時にこれらの内部不一致が表面化します。
解決策
IronPdfEngine を Docker コンテナとして実行し、SDK を HTTP 経由でそれに接続するように構成します。これにより、IronPDF SDK の Zod 型が NestJS モジュール解決から取り除かれ、ビルドエラーが止まります。
IronPdfEngine コンテナを開始します:
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5IronPDF をコンテナを利用するように構成します:
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";
IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000";NestJS サービスから通常のように IronPDF を使用します:
import { PdfDocument } from "@ironsoftware/ironpdf";
const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>");
await pdf.saveAs("output.pdf");エンジンが Docker で動作している場合、NestJS アプリケーションは HTTP 経由で IronPdfEngine を呼び出します。SDK の内部 Zod 型宣言はもはや TypeScript コンパイルに参加しません。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。
