如何為 IronPDF 提交工程支援請求
感謝您抽出時間幫助我們改進 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
}
}另外,請確保您的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>如果你的專案中沒有pom.xml文件,請確保你已下載slf4j-simple JAR 文件,並在你的專案中引用了該文件。
如何附加範例項目
一個能夠準確地重現整個問題的範例項目,可以讓我們的工程師簡單快速地識別和理解問題。
這是可復現性的黃金標準,通常可以加快支援請求到達最高層級的處理速度。
我們首選的格式是壓縮的、簡單的、獨立的 Java 控制台或 Web 應用程式專案:
有關如何準備專案的更多指導,請參閱IronPDF 的《建立範例專案指南》 。
- 傳送 Google Drive 或 Dropbox 連結時,請啟用完全分享。
請同時提供:
- 輸入文件(工作文件和非工作文件),包括 PDF 文件、引用資源(CSS 文件、圖像)
- 輸出 PDF 檔案(如適用)和/或預期輸出







