如何提出IronPDF的工程支持请求

2022年一月19日
更新 2024年十月20日
分享:
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 方法之前,将以下代码放在代码的顶部:

Settings.setIronPdfEnginePort(33350);
Settings.setDebug(true);
Settings.setLogPath(Paths.get("C:/tmp/Default.log"));
JAVA

还要确保在pom.xml文件中包含SLF4J依赖项:

<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(如果适用)和/或预期的输出