How to Make an Engineering Support Request for IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

我們感謝您花時間幫助我們改進IronPDF並解決您可能遇到的任何問題。 我們的大多數功能和更新都是由客戶需求驅動的,我們將軟件開發視為我們客戶與開發者之間的雙向對話。

為了提供支持,我們的工程團隊需要能夠有效地重現問題並創建回歸測試。 我們看到的大多數問題都是平台或運行時特定的。 因此,我們需要提供非常簡潔的信息。

請將所有支持請求發送至 support@ironsoftware.com

明確簡潔的問題描述

一份好的技術報告必須包含足夠的信息以重現問題。 想像一下,您正在向同事報告問題或在Stack Overflow上發布。

錯誤報告應包含:

  • 體驗的症狀的明確描述,以及您可能對其原因的任何想法。
  • 日誌文件(見下文)
  • 環境:IronPDF版本、操作系統、Java運行時版本和確切的雲環境(如適用)

請儘可能多附上以下項目,以優先處理您的票務。

  • 完全重現問題的示例項目(見下文)
  • Stack Overflow風格的代碼段(請不要截圖代碼)
  • 症狀/異常的截圖
  • 異常消息文本(異常+內部異常)
  • 在調試時,過程在哪個點停止運行或在代碼中中斷?
  • 輸入參數和資產:URL、HTML、HTML文件、圖像、PDF、CSS等。

如何附加IronPDF日誌文件

附加日誌文件到您的錯誤報告中將使我們能夠幫助您的概率加倍。

注意:IronPDF具有一些需要啟用的詳細錯誤記錄功能。

如何啟用日誌

您可以訪問ironpdf.com上的IronPDF日誌設置指南,找到有關如何啟用日誌的詳細說明。

在運行任何其他IronPDF方法之前,將以下代碼放在代碼的頂部:

import com.ironsoftware.Ironpdf.Settings; 
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) {
        // Set the port for IronPDF engine
        Settings.setIronPdfEnginePort(33350);
        // Enable detailed debug output
        Settings.setDebug(true);
        // Set the path for the log files
        Settings.setLogPath(Paths.get("C:/tmp/Default.log"));

        // Your code logic here
    }
}
import com.ironsoftware.Ironpdf.Settings; 
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) {
        // Set the port for IronPDF engine
        Settings.setIronPdfEnginePort(33350);
        // Enable detailed debug output
        Settings.setDebug(true);
        // Set the path for the log files
        Settings.setLogPath(Paths.get("C:/tmp/Default.log"));

        // Your code logic here
    }
}
JAVA

還請確保在您的pom.xml文件中有SLF4J依賴:

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>2.0.5</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>2.0.5</version>
</dependency>
XML

如果您的項目中沒有pom.xml文件,請確保您已下載並在您的項目中引用了slf4j-simple JAR文件。

如何附加示例項目

能夠準確復制整個問題的孤立示例項目使我們的工程師能夠簡單而迅速地識別和理解問題。

這是可重現性的黃金標準,通常會將支持請求加速到堆疊的頂部。

我們首選的格式是一個壓縮的、簡單的、獨立的Java控制台或Web應用程序項目:

有關如何準備項目的更多指導,請參閱IronPDF的創建示例項目指南

  • 在發送Google Drive或Dropbox鏈接時,請啟用完全共享。

還請包括:

  • 輸入文件(工作和非工作),包括PDF,引用的資產(CSS,圖像)
  • 輸出PDF(如適用)和/或期望的輸出
Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
版本: 2025.11 剛剛發布