Technical Anshu
Tutorials Blog
☕ Java-Versionskorrektur

Jira JAVA HOME ist nicht eingestellt oder die JDK-Version ist falsch. Beheben Sie das Java-Problem hinter dem Startfehler

Jira ist ein Java-Programm mit einer Weboberfläche. Wenn sich das darunter liegende Java ändert oder verschwindet, fällt Jira schneller aus, als es überhaupt ein Protokoll schreiben kann – und diese Geschwindigkeit ist Ihr Anhaltspunkt.

✍️ Technical Anshu🪟 Windows Server⏱️ 8 minute read
🎥 Sehen Sie sich die vollständige Lösung im Video an – jeder Schritt wird live auf dem Bildschirm gezeigt

Einige Jira-Startfehler führen zu langen Protokollen. Java-Fehler führen zu fast nichts, denn wenn Java nicht gestartet werden kann, kann Jira nicht ausgeführt werden – und sich nicht anmelden. Die übliche Geschichte: Jemand hat das JDK aktualisiert, eine Windows-Bereinigung hat ein altes Java entfernt oder JAVA_HOME wurde für eine andere Anwendung geändert, und der Dienst von Jira zeigt jetzt auf ein fehlendes Java, 32-Bit, wo es 64-Bit sein sollte, oder einfach auf eine Version, die Ihre Jira-Version nicht unterstützt. Auf dieser Seite erfahren Sie, wie Sie herausfinden, welches Java Jira tatsächlich verwendet wird, und wie Sie es richtig einstellen.

Command Prompt - checking the Java Jira will actually use (illustration)
java -version java version "1.8.0_202" (the PATH Java - not always Jira's Java) setenv.bat says: JAVA_HOME=C:\Java\jdk-21 Problem: this Jira version does not support Java 21.
Die Version in Ihrem PATH und die von Jira verwendete Version können zwei verschiedene Dinge sein. Beispielwerte zur Veranschaulichung.
1

Verstehen Sie, wie Jira sein Java auswählt

Jira verwendet nicht einfach das, was Java Windows bevorzugt. Seine Startskripte betrachten zuerst JAVA_HOME, dann JRE_HOME, und der Windows-Dienst verwendet das in seiner eigenen Konfiguration aufgezeichnete Java. Deshalb sind „Java ist installiert“ und „Jira schlägt immer noch fehl“ beide gleichzeitig wahr – es handelt sich um unterschiedliche Java-Installationen.

  1. Öffnen Sie den Jira-Ordner bin im Installationsverzeichnis und suchen Sie nach setenv.bat.
  2. Suchen Sie nach Zeilen, die JAVA_HOME oder JRE_HOME festlegen – notieren Sie sich den genauen Ordner, den sie benennen
  3. Öffnen Sie diesen Ordner und bestätigen Sie, dass darin tatsächlich ein Ordner bin mit java.exe vorhanden ist
  4. Führen Sie diese Kopie direkt aus: java -version aus dem Ordner bin und notieren Sie die Version
  5. Wenn der genannte Ordner nicht existiert, haben Sie den Fehler gefunden – Jira zeigt auf ein Java, das verschoben oder entfernt wurde
2

Passen Sie das JDK genau an Ihre Jira-Version an

Dies ist der Schritt, bei dem die Leute raten, und das Raten ist teuer. Jede Jira-Version unterstützt einen bestimmten Satz von Java-Versionen: Ältere Jira-Versionen laufen auf Java 8 oder 11, neuere erfordern Java 11 oder 17 und die neuesten erfordern Java 17 oder höher. Ein zu neues Java schlägt genauso schwer fehl wie ein zu altes – die Klassendatei- und Moduländerungen sind real und nicht umständlich.

  1. Finden Sie Ihre Jira-Version – sie befindet sich in der Fußzeile jeder Jira-Seite, in der Versionsdatei der Installation oder in Ihrem letzten funktionierenden atlassian-jira.log
  2. Öffnen Sie die Seite Unterstützte Plattformen von Atlassian für genau diese Jira-Version und lesen Sie die Java-Anforderungen
  3. Vergleichen Sie es mit der Version, die Sie im vorherigen Abschnitt überprüft haben – sie müssen sich überschneiden
  4. Wenn dies nicht der Fall ist, besteht die ehrliche Lösung darin, Jira auf ein unterstütztes JDK hinzuweisen (bei Bedarf eines nebeneinander zu installieren) und nicht das aktuelle zu erzwingen
  5. Vermeiden Sie vollständig 32-Bit-Java – Jira benötigt eine 64-Bit-JVM, um einen nützlichen Heap zu verwenden
3

Korrigieren Sie JAVA_HOME und die Dienstkonfiguration

Sobald Sie das richtige JDK kennen, sorgen Sie dafür, dass alle Zeiger übereinstimmen. Das Ändern nur der Systemumgebungsvariablen ist die klassische Halblösung: Der Dienst verwendet möglicherweise weiterhin das in seinen eigenen Wrapper-Einstellungen gespeicherte Java, und der Fehler überlebt Ihre Reparatur.

  1. Stoppen Sie den Jira-Dienst
  2. Bearbeiten Sie setenv.bat so, dass JAVA_HOME den unterstützten JDK-Ordner benennt – kein abschließendes bin, nur das JDK-Stammverzeichnis
  3. Überprüfen Sie auch die Windows-Systemumgebungsvariablen, falls dort ein widersprüchlicher JAVA_HOME festgelegt ist
  4. Wenn Ihr Jira als Dienst ausgeführt wird, öffnen Sie die Java-Einstellungen des Dienstes mit dem Tomcat-Dienstkonfigurationstool im Jira-Ordner bin und bestätigen Sie, dass der Java-Pfad dort übereinstimmt
  5. Starten Sie den Dienst und sehen Sie sich das Catalina-Protokoll an – ein korrektes Java zeigt, dass Jira in die Port- und Datenbankphase übergeht
4

Erkennen Sie die Signaturen eines Java-Fehlers

Java-Probleme haben Tells. Der Dienst schlägt innerhalb von Sekunden fehl. Die Windows-Ereignisanzeige zeigt den Dienst- oder JVM-Fehler an, bevor die eigenen Protokolle von Jira überhaupt beginnen. Und wenn Protokolle vorhanden sind, benennen Ausdrücke wie UnsupportedClassVersionError (Java zu alt für den Code) oder Modulzugriffsfehler (Java zu neu und streng) die Nichtübereinstimmung direkt. Bei der Meldung „Die Java Virtual Machine konnte nicht erstellt werden“ handelt es sich jedoch normalerweise um Speichereinstellungen, nicht um die Version – das gehört zum Heap-Fix, nicht zu diesem.

  1. Überprüfen Sie die Fehlergeschwindigkeit: Sekunden bedeutet Java oder Heap; Minuten bedeuten spätere Phasen
  2. Überprüfen Sie das Anwendungsprotokoll der Ereignisanzeige zum Zeitpunkt des Fehlers auf JVM-Fehler
  3. Durchsuchen Sie das Catalina-Protokoll nach den Fehlern UnsupportedClassVersionError oder java.lang am Anfang des Fehlers
🔴 Ändern Sie eine Sache nach der anderen. Java-Reparaturen verleiten Menschen dazu, Jira, Java und den Datenbanktreiber an einem Nachmittag zu aktualisieren. Wenn das System dann funktioniert, werden Sie nie wissen, welche Änderung von Bedeutung war – und wenn es fehlschlägt, haben Sie drei Verdächtige statt einem. Korrigieren Sie den Java-Zeiger, starten Sie Jira, bestätigen Sie und planen Sie erst dann ein Upgrade – wobei zunächst ein Backup des Jira-Home-Verzeichnisses und der Jira-Datenbank erstellt wird.

🎥 Sehen Sie sich den vollständigen Fix im Video an

Die vollständige Jira-Startreparatur, Schritt für Schritt, mit den genauen Bildschirmen und Protokollzeilen, die live angezeigt werden.

▶️ Watch Full Video
❓ Häufige Fragen (FAQ)

Java ist installiert und funktioniert einwandfrei für andere Apps. Warum scheitert Jira immer noch?

Weil Jira wahrscheinlich nicht dieses Java verwendet. Jira folgt JAVA_HOME in seiner eigenen setenv.bat und dem in seiner Windows-Dienstkonfiguration aufgezeichneten Java, das auf ein älteres oder entferntes JDK verweisen kann, während andere Anwendungen problemlos das System-Java verwenden. Überprüfen Sie die genaue java.exe im Ordner, auf den Jira verweist, und führen Sie die Java-Version aus diesem Ordner aus.

Sollte ich Java auf die neueste Version aktualisieren, um Jira zu reparieren?

Nur wenn die Seite „Unterstützte Plattformen“ von Atlassian für Ihre genaue Jira-Version diese Java-Version auflistet. Neueres wird nicht automatisch unterstützt – ein zu neues Java bricht Jira genauso zuverlässig wie ein zu altes, durch geänderte Klassenversionen und strengere Modulregeln. Entspricht dem dokumentierten Bereich; Verfolgen Sie nicht die höchste Zahl.

Jira begann direkt nach einem Java-Update auf dem Server auszufallen. Was ist passiert?

Das Update ersetzte oder entfernte wahrscheinlich das JDK, auf das JAVA_HOME von Jira verweist, oder änderte das System JAVA_HOME, das ein anderer Administrator später in die Konfiguration von Jira kopierte. Die Lösung besteht nicht darin, den gesamten Server zurückzusetzen – installieren oder behalten Sie ein unterstütztes JDK nebeneinander und verweisen Sie nur Jira darauf, indem Sie setenv.bat und die Java-Einstellungen des Dienstes verwenden.

Diese Anleitung basiert auf dem Technical Anshu-Video zur Behebung eines nicht startenden Jira. • Sie stecken bei einer Stufe fest? Fragen Sie in den Videokommentaren nach – Sie erhalten eine Antwort 🙏