Erros de Compilação do IronPDF NestJS TypeScript

Atualizado:junho 9, 2026

Translated

View the article in English

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

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

SHELL

Configure o IronPDF para usar o contêiner:

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

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