1. IronPDF
  2. トラブルシューティング
  3. IronPDF NestJS TypeScript ビルドエラー

IronPDF NestJS TypeScript ビルドエラー

Curtis Chau
Curtis Chau
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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.5
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5
SHELL

IronPDF をコンテナを利用するように構成します:

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
Curtis Chau
  今すぐエンジニアリングチームとチャット
テクニカルライター

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

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？
バージョン: 2026.6 リリースされたばかり
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか?
サンプルを実行するHTML が PDF に変換されるのを確認します。