IronPDF NestJS TypeScript 빌드 오류

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 프로젝트보다 엄격한 모듈 해석을 적용하므로, 이러한 내부 불일치를 컴파일 시 드러냅니다.

해결책

IronPdfEngine을 Docker 컨테이너로 실행하고 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";

IronPDF를 NestJS 서비스에서 정상적으로 사용:

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
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
버전: 2026.6 방금 출시
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요?
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.