IronPDF NestJS TypeScript Build Errors
Das Hinzufügen des IronPDF Node.js SDK zu einem NestJS-Projekt führt zu einem Fehler beim Kompilieren in TypeScript:
Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'.
Zod-Schema-Deklarationen innerhalb des IronPDF SDK (affixSchema.ts, imageSchema.ts, pageSchema.ts) definieren Typen, die nicht den erwarteten Objektschemata in NestJS TypeScript-Builds entsprechen. NestJS erzwingt eine strengere Modulauflösung als ein einfaches Node.js-Projekt, was diese internen Abweichungen zur Kompilierungszeit sichtbar macht.
Lösung
Führen Sie IronPdfEngine als Docker-Container aus und konfigurieren Sie das SDK, um über HTTP darauf zuzugreifen. Dadurch werden die Zod-Typen des IronPDF SDK aus der NestJS-Modulauflösung entfernt, was die Build-Fehler behebt.
Start the IronPdfEngine container:
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5
Konfigurieren Sie IronPDF zur Nutzung des Containers:
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";
IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000";
Verwenden Sie IronPDF normal von einem NestJS-Dienst aus:
import { PdfDocument } from "@ironsoftware/ironpdf";
const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>");
await pdf.saveAs("output.pdf");
Mit dem in Docker laufenden Engine ruft die NestJS-Anwendung IronPdfEngine über HTTP auf. Die internen Zod-Typ-Deklarationen des SDK nehmen nicht mehr an der TypeScript-Kompilierung teil.

