Niepowodzenie polaczenia IronPdfEngine z duzego pliku JAR

Curtis Chau

Updated: 3 lipca 2026

Download IronPDF

• Maven Central Download
• DLL Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Niepowodzenie polaczenia IronPdfEngine z duzego pliku JAR Gdy aplikacja IronPDF for Java jest pakowana jako duzy (uber) JAR, klient nie moze polaczyc sie z wewnetrznym silnikiem renderowania. `IronPdfEngine` uruchamia sie i nasluchuje na poprawnym porcie, ale klient Java podejmuje 20 prób polaczenia i za kazdym razem ponosi porazke. ```txt Failed to connect to IronPdfEngine after 20 attempts ``` Niepowodzenie wynika z polaczenia kazdej zaleznosci w jeden samodzielnie zmontowany cienisty (uber) JAR - na przyklad za pomoca dodatku Maven Shade lub Gradle Shadow. Nakladajace sie pliki zasobow z polaczonych zaleznosci uniemozliwiaja klientowi Java dotarcie do `IronPdfEngine` procesu podrzednego: silnik uruchamia sie i otwiera oczekiwany port, ale klient nigdy sie nie polaczy i rezygnuje po 20 probach. Utrzymanie kazdej zaleznosci jako oddzielnego pliku w sciezce klas eliminuje konflikt. ## Rozwiązanie Zbuduj projekt normalnie, skopiuj jego zaleznosci do folderu, a nastepnie uruchom aplikacje, kierujac Java bezposrednio na te pliki zamiast uzywac `java -jar`. ### 1. Zbuduj projekt ```bash mvn clean package ``` ### 2. Skopiuj zaleznosci podczas wykonywania Umiesc kazda biblioteke w `target/libs` jako osobne pliki JAR, jak wymaga tego podejscie sciezki klas: ```bash mvn dependency:copy-dependencies -DoutputDirectory=target/libs ``` ### 3. Uruchom ze sciezki klas Uruchom aplikacje w odniesieniu do eksplodowanej sciezki klas zamiast do duzego pliku JAR. Zamien `com.example.Main` na swoja faktyczna glowna klase. **Windows:** ```bash java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes;target/libs/*" com.example.Main ``` **Linux / macOS:** ```bash java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes:target/libs/*" com.example.Main ``` Jedyna roznica miedzy dwoma poleceniami jest separator sciezki klas: srednik (`;`) w systemie Windows, dwukropek (`:`) w systemach Linux i macOS. ## Wskazówki dotyczące debugowania - **Co nie dziala:** uruchomienie z duzego pliku JAR poprawnie uruchamia `IronPdfEngine`, ale klient Java nigdy sie nie laczy. - **`--add-opens` sam nie wystarczy:** dodanie flagi JVM podczas uruchamiania z duzego pliku JAR nie naprawia problemu z polaczeniem. Flaga ma znaczenie tylko w przypadku powyzszego uruchomienia sciezki klas. - **Ciagi wersji PDF/A:** jezeli twoj kod przekazuje wersje PDF/A jako argument lancuchowy, uzyj `PdfA2a`, nie `PdfAVersions.PdfA2a`.

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Gdy aplikacja IronPDF for Java jest pakowana jako duzy (uber) JAR, klient nie moze polaczyc sie z wewnetrznym silnikiem renderowania. IronPdfEngine uruchamia sie i nasluchuje na poprawnym porcie, ale klient Java podejmuje 20 prób polaczenia i za kazdym razem ponosi porazke.

Failed to connect to IronPdfEngine after 20 attempts

Failed to connect to IronPdfEngine after 20 attempts

Niepowodzenie wynika z polaczenia kazdej zaleznosci w jeden samodzielnie zmontowany cienisty (uber) JAR - na przyklad za pomoca dodatku Maven Shade lub Gradle Shadow. Nakladajace sie pliki zasobow z polaczonych zaleznosci uniemozliwiaja klientowi Java dotarcie do IronPdfEngine procesu podrzednego: silnik uruchamia sie i otwiera oczekiwany port, ale klient nigdy sie nie polaczy i rezygnuje po 20 probach. Utrzymanie kazdej zaleznosci jako oddzielnego pliku w sciezce klas eliminuje konflikt.

Rozwiązanie

Zbuduj projekt normalnie, skopiuj jego zaleznosci do folderu, a nastepnie uruchom aplikacje, kierujac Java bezposrednio na te pliki zamiast uzywac java -jar.

1. Zbuduj projekt

mvn clean package

mvn clean package

2. Skopiuj zaleznosci podczas wykonywania

Umiesc kazda biblioteke w target/libs jako osobne pliki JAR, jak wymaga tego podejscie sciezki klas:

mvn dependency:copy-dependencies -DoutputDirectory=target/libs

mvn dependency:copy-dependencies -DoutputDirectory=target/libs

3. Uruchom ze sciezki klas

Uruchom aplikacje w odniesieniu do eksplodowanej sciezki klas zamiast do duzego pliku JAR. Zamien com.example.Main na swoja faktyczna glowna klase.

Windows:

java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes;target/libs/*" com.example.Main

java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes;target/libs/*" com.example.Main

Linux / macOS:

java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes:target/libs/*" com.example.Main

java --add-opens java.base/java.nio=ALL-UNNAMED -cp "target/classes:target/libs/*" com.example.Main

Jedyna roznica miedzy dwoma poleceniami jest separator sciezki klas: srednik (;) w systemie Windows, dwukropek (:) w systemach Linux i macOS.

Wskazówki dotyczące debugowania

• Co nie dziala: uruchomienie z duzego pliku JAR poprawnie uruchamia IronPdfEngine, ale klient Java nigdy sie nie laczy.
• --add-opens sam nie wystarczy: dodanie flagi JVM podczas uruchamiania z duzego pliku JAR nie naprawia problemu z polaczeniem. Flaga ma znaczenie tylko w przypadku powyzszego uruchomienia sciezki klas.
• Ciagi wersji PDF/A: jezeli twoj kod przekazuje wersje PDF/A jako argument lancuchowy, uzyj PdfA2a, nie PdfAVersions.PdfA2a.

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