Erros de Compilação do IronPDF NestJS TypeScript

Curtis Chau

Updated: 10 de junho de 2026

Download IronPDF

• Node Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Erros de Compilação do IronPDF NestJS TypeScript Adicionar o SDK do IronPDF Node.js a um projeto NestJS faz com que o TypeScript falhe em tempo de compilação: ```txt Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'. ``` Declarações de esquema Zod dentro do SDK do IronPDF (`affixSchema.ts`, `imageSchema.ts`, `pageSchema.ts`) definem tipos que não correspondem aos formatos de objeto esperados nas compilações do NestJS TypeScript. NestJS impõe uma resolução de módulo mais rigorosa do que um projeto Node.js simples, o que evidencia essas discrepâncias internas em tempo de compilação. ## Solução Execute o IronPdfEngine como um contêiner Docker e configure o SDK para se conectar a ele via HTTP. Isso remove os tipos Zod do SDK do IronPDF da resolução de módulos do NestJS, interrompendo as falhas de compilação. **Inicie o contêiner IronPdfEngine:** ```bash docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5 ``` **Configure o IronPDF para usar o contêiner:** ```typescript import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf"; IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000"; ``` **Use o IronPDF normalmente a partir de um serviço NestJS:** ```typescript import { PdfDocument } from "@ironsoftware/ironpdf"; const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>"); await pdf.saveAs("output.pdf"); ``` Com a engine rodando no Docker, a aplicação NestJS chama o IronPdfEngine via HTTP. As declarações internas de tipo Zod do SDK não participam mais da compilação TypeScript. - [Como Fazer uma Solicitação de Suporte Técnico para o 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

Adicionar o SDK do IronPDF Node.js a um projeto NestJS faz com que o TypeScript falhe em tempo de compilação:

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

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

Declarações de esquema Zod dentro do SDK do IronPDF (affixSchema.ts, imageSchema.ts, pageSchema.ts) definem tipos que não correspondem aos formatos de objeto esperados nas compilações do NestJS TypeScript. NestJS impõe uma resolução de módulo mais rigorosa do que um projeto Node.js simples, o que evidencia essas discrepâncias internas em tempo de compilação.

Solução

Execute o IronPdfEngine como um contêiner Docker e configure o SDK para se conectar a ele via HTTP. Isso remove os tipos Zod do SDK do IronPDF da resolução de módulos do NestJS, interrompendo as falhas de compilação.

Inicie o contêiner IronPdfEngine:

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

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

Configure o IronPDF para usar o contêiner:

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

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

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

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

Use o IronPDF normalmente a partir de um serviço 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");

Com a engine rodando no Docker, a aplicação NestJS chama o IronPdfEngine via HTTP. As declarações internas de tipo Zod do SDK não participam mais da compilação TypeScript.

• Como Fazer uma Solicitação de Suporte Técnico para o IronPDF

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...

Leia mais