如何为 IronPDF 申请工程支持。

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

感谢您抽出时间帮助我们改进 IronPDF 并解决您可能遇到的任何问题。 我们的绝大多数功能和更新都是由客户要求驱动的,我们认为软件开发是客户和开发人员之间的双向对话。

为了提供支持,我们的工程团队需要能够有效地复制问题并创建回归测试。 我们遇到的大多数问题都与平台或运行时有关。 因此,我们需要提供非常简明的信息。

请将所有支持请求发送至 support@ironsoftware.com

简洁、清晰的问题描述

一份好的技术报告必须包含足够的信息来重现问题。 想象一下,您正在向同事报告问题或在 Stack Overflow 上发帖。

错误报告应包括

  • 清楚地描述所经历的症状以及您对其原因的任何想法。
  • 日志文件(见下文)
  • 环境:IronPDF for Java 版本、操作系统、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 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
版本: 2025.12 刚刚发布