Errores de compilación de IronPDF NestJS TypeScript

Curtis Chau

Updated: 10 de junio de 2026

Download IronPDF

• Node Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Errores de compilación de IronPDF NestJS TypeScript Agregar el SDK de IronPDF Node.js a un proyecto de NestJS hace que TypeScript falle en tiempo de compilación: ```txt Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'. ``` Las declaraciones de esquema Zod dentro del SDK de IronPDF (`affixSchema.ts`, `imageSchema.ts`, `pageSchema.ts`) definen tipos que no coinciden con las formas de objetos esperadas en las compilaciones de NestJS TypeScript. NestJS impone una resolución de módulo más estricta que un proyecto de Node.js simple, lo que hace visibles estos desajustes internos en tiempo de compilación. ## Solución Ejecuta IronPdfEngine como un contenedor de Docker y configura el SDK para conectarse a él a través de HTTP. Esto elimina los tipos Zod del SDK de IronPDF de la resolución de módulos de NestJS, deteniendo los errores de compilación. **Iniciar el contenedor de IronPdfEngine:** ```bash docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5 ``` **Configurar IronPDF para usar el contenedor:** ```typescript import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf"; IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000"; ``` **Utilizar IronPDF normalmente desde un servicio de NestJS:** ```typescript import { PdfDocument } from "@ironsoftware/ironpdf"; const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>"); await pdf.saveAs("output.pdf"); ``` Con el motor ejecutándose en Docker, la aplicación NestJS llama a IronPdfEngine a través de HTTP. Las declaraciones de tipo Zod internas del SDK ya no participan en la compilación de TypeScript. - [Cómo hacer una solicitud de soporte técnico para IronPDF](/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

Agregar el SDK de IronPDF Node.js a un proyecto de NestJS hace que TypeScript falle en tiempo de compilación:

Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'.

Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'.

Las declaraciones de esquema Zod dentro del SDK de IronPDF (affixSchema.ts, imageSchema.ts, pageSchema.ts) definen tipos que no coinciden con las formas de objetos esperadas en las compilaciones de NestJS TypeScript. NestJS impone una resolución de módulo más estricta que un proyecto de Node.js simple, lo que hace visibles estos desajustes internos en tiempo de compilación.

Solución

Ejecuta IronPdfEngine como un contenedor de Docker y configura el SDK para conectarse a él a través de HTTP. Esto elimina los tipos Zod del SDK de IronPDF de la resolución de módulos de NestJS, deteniendo los errores de compilación.

Iniciar el contenedor de IronPdfEngine:

docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5

docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5

Configurar IronPDF para usar el contenedor:

import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000";

import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000";

Utilizar IronPDF normalmente desde un servicio de NestJS:

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

Con el motor ejecutándose en Docker, la aplicación NestJS llama a IronPdfEngine a través de HTTP. Las declaraciones de tipo Zod internas del SDK ya no participan en la compilación de TypeScript.

• Cómo hacer una solicitud de soporte técnico para IronPDF

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...

Leer más