IronPDF NestJS TypeScript Build Errors

Curtis Chau

Updated: 10. Juni 2026

Download IronPDF

• Node Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # 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: ```txt 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:** ```bash docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5 ``` **Konfigurieren Sie IronPDF zur Nutzung des Containers:** ```typescript import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf"; IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000"; ``` **Verwenden Sie IronPDF normal von einem NestJS-Dienst aus:** ```typescript 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. - [Wie man eine technische Unterstützung für IronPDF anfordert](/nodejs/troubleshooting/engineering-request-pdf/)

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

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'.

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";

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

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.

• Wie man eine technische Unterstützung für IronPDF anfordert

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...

Weiterlesen