1. IronPDF
  2. 故障排除
  3. IronPDF NestJS TypeScript 构建错误

IronPDF NestJS TypeScript 构建错误

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

将 IronPDF Node.js SDK 添加到 NestJS 项目会导致 TypeScript 在编译时失败：

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

IronPDF SDK 内的 Zod 模式声明 (affixSchema.ts, imageSchema.ts, pageSchema.ts) 定义的类型与 NestJS TypeScript 构建中预期的对象结构不匹配。 NestJS 实施更严格的模块解析规则，比普通 Node.js 项目更加严格，这在编译时就暴露出这些内部不匹配。

解决方案

以 Docker 容器形式运行 IronPdfEngine，并配置 SDK 通过 HTTP 连接到它。这将 IronPDF SDK 的 Zod 类型从 NestJS 模块解析中移除，阻止构建失败。

启动 IronPdfEngine 容器：

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

配置 IronPDF 使用容器：

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

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

从 NestJS 服务正常使用 IronPDF：

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

const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>");
await pdf.saveAs("output.pdf");

当引擎在 Docker 中运行时，NestJS 应用通过 HTTP 调用 IronPdfEngine。SDK 的内部 Zod 类型声明不再参与 TypeScript 编译。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
版本: 2026.6 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？
运行示例看着你的HTML代码变成PDF文件。