IronPDF NestJS TypeScript Derleme Hataları

Curtis Chau

Updated: 10 Haziran 2026

Download IronPDF

• Node Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # IronPDF NestJS TypeScript Derleme Hataları IronPDF Node.js SDK'yi bir NestJS projesine eklemek, TypeScript'in derleme sırasında başarısız olmasına neden olur: ```txt Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'. ``` IronPDF SDK içindeki Zod şema deklarasyonları (`affixSchema.ts`, `imageSchema.ts`, `pageSchema.ts`), NestJS TypeScript derlemelerinde beklenen nesne şekilleriyle uyuşmayan türler tanımlar. NestJS, düz bir Node.js projesinden daha katı modül çözünürlüğünü zorunlu kılar, bu da bu içsel uyumsuzlukları derleme sırasında ortaya çıkarır. ## Çözüm IronPdfEngine'i bir Docker konteyneri olarak çalıştırın ve SDK'nın HTTP üzerinden ona bağlanacak şekilde yapılandırın. Bu, IronPDF SDK'nın Zod türlerini NestJS modül çözümünden çıkarır ve derleme hatalarını durdurur. **IronPdfEngine konteynerini başlatın:** ```bash docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5 ``` **IronPDF'i konteyneri kullanacak şekilde yapılandırın:** ```typescript import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf"; IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000"; ``` **NestJS hizmetinden IronPDF'i normal olarak kullanın:** ```typescript import { PdfDocument } from "@ironsoftware/ironpdf"; const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>"); await pdf.saveAs("output.pdf"); ``` Motor Docker'da çalışıyorken, NestJS uygulaması IronPdfEngine'i HTTP üzerinden arar. SDK'nın iç Zod türü deklarasyonları artık TypeScript derleme sürecine katılmaz. - [IronPDF için Mühendislik Destek Talebi Nasıl Yapılır](/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

IronPDF Node.js SDK'yi bir NestJS projesine eklemek, TypeScript'in derleme sırasında başarısız olmasına neden olur:

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

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

IronPDF SDK içindeki Zod şema deklarasyonları (affixSchema.ts, imageSchema.ts, pageSchema.ts), NestJS TypeScript derlemelerinde beklenen nesne şekilleriyle uyuşmayan türler tanımlar. NestJS, düz bir Node.js projesinden daha katı modül çözünürlüğünü zorunlu kılar, bu da bu içsel uyumsuzlukları derleme sırasında ortaya çıkarır.

Çözüm

IronPdfEngine'i bir Docker konteyneri olarak çalıştırın ve SDK'nın HTTP üzerinden ona bağlanacak şekilde yapılandırın. Bu, IronPDF SDK'nın Zod türlerini NestJS modül çözümünden çıkarır ve derleme hatalarını durdurur.

IronPdfEngine konteynerini başlatın:

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

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

IronPDF'i konteyneri kullanacak şekilde yapılandırın:

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

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

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

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

NestJS hizmetinden IronPDF'i normal olarak kullanın:

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

Motor Docker'da çalışıyorken, NestJS uygulaması IronPdfEngine'i HTTP üzerinden arar. SDK'nın iç Zod türü deklarasyonları artık TypeScript derleme sürecine katılmaz.

• IronPDF için Mühendislik Destek Talebi Nasıl Yapılır

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku