Jak złożyć zgłoszenie wsparcia inżynierskiego dla IronPDF

Updated: 22 kwietnia 2026

Dziękujemy za poświęcenie czasu, aby pomóc nam ulepszyć IronPDF i rozwiązać wszelkie problemy, które mogą wystąpić. Większość naszych funkcji i aktualizacji jest oparta na zgłoszeniach klientów, a my traktujemy rozwój oprogramowania jako dwukierunkową rozmowę między naszymi klientami a naszymi deweloperami.

Aby zapewnić wsparcie, nasz zespół inżynierski musi być w stanie wydajnie replikówać problem i tworzyć testy regresji. Większość problemów, które widzimy, dotyczy konkretnej platformy lub środowiska uruchomieniowego. W związku z tym potrzebujemy niezwykle zwięzłych informacji.

Prosimy o przesyłanie wszystkich próśb o wsparcie na support@ironsoftware.com.

Zwięzły, jasny opis problemu

Dobry raport techniczny musi zawierać wystarczająco informacji do odtworzenia problemu. Wyobraź sobie, że zgłaszasz problem koledze lub publikujesz na Stack Overflow.

Zgłoszenie błędu powinno zawierać:

Jasny opis doświadczanych objawów i wszelkie pomysły, które możesz mieć na temat ich przyczyny.
Pliki dziennika (patrz poniżej)
Środowisko: Wersja IronPDF, system operacyjny, wersja środowiska uruchomieniowego Java oraz dokładne środowisko chmurowe (jeśli dotyczy)

Prosimy o dołączenie jak największej liczby z poniższych elementów, aby priorytetyzować zgłoszenie.

Przykładowy projekt, który w pełni odtwarza problem (patrz poniżej)
Fragment kodu w stylu Stack Overflow (prosimy nie robić zrzutów ekranu kodu)
Zrzuty ekranu objawów/wyjątków
Tekst wiadomości o wyjątku (Wyjątek + Wyjątek wewnętrzny)
W którym punkcie debugowania proces przestaje działać lub opuszcza kod?
Parametry wejściowe i zasoby: URL, HTML, plik HTML, obraz, PDF, CSS itd.

Jak załączyć pliki dziennika IronPDF

Dołączenie plików dziennika do zgłoszenia błędu ponad dwukrotnie zwiększa prawdopodobieństwo, że będziemy w stanie Ci pomóc.

NOTA: IronPDF posiada szczegółowe możliwości rejestrowania błędów, które należy włączyć.

Jak włączyć dzienniki

Można znaleźć szczegółowe instrukcje, jak włączyć rejestrowanie, odwiedzając Przewodnik po rejestracji IronPDF na ironpdf.com.

Umieść poniższy kod na początku swojego kodu, przed uruchomieniem jakichkolwiek metod 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

Upewnij się również, że masz zależność SLF4J w pliku pom.xml.

<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

Jeśli nie masz pliku pom.xml w twoim projekcie, upewnij się, że masz pobrany plik JAR slf4j-simple i że jest odwołany w twoim projekcie.

Jak załączyć przykładowy projekt

Przykładowy projekt, który dokładnie odtwarza cały problem w izolacji umożliwia naszym inżynierom proste i szybkie rozpoznanie oraz zrozumienie problemu.

To złoty standard powtarzalności i generalnie przyspieszy wniosek o wsparcie na szczyt stosu.

Preferowany przez nas format to skompresowany, prosty, samodzielny projekt konsolowy lub webowy w Java:

W celu uzyskania dodatkowych wskazówek dotyczących przygotowania projektu odnieś się do Przewodnika IronPDF dotyczącego tworzenia projektów przykładowych.

Prosimy o włączenie pełnego udostępniania podczas wysyłania linku z Google Drive lub Dropbox.

Prosimy również o dołączenie:

Plików wejściowych (działających i niedziałających), w tym plików PDF, powiązanych zasobów (CSS, obrazy)
Wyjściowych plików PDF (jeśli dotyczy) i/lub oczekiwanego rezultatu

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej