Wiki source code of Basisprojekt FAQ

Last modified by Marco Grawunder on 2026/10/19 15:32

Show last authors
1 {{info}}
2 **Worum geht es auf dieser Seite?**
3
4 Diese FAQ sammelt **häufige Probleme beim Einrichten, Bauen und Starten des Basisprojekts**. Die zusammenhängende Einführung steht auf der Seite [[Basisprojekt>>doc:Main.Basisprojekt.WebHome]].
5 {{/info}}
6
7 {{toc/}}
8
9 == Es gibt überall Fehlermeldung und das Programm lässt sich nicht kompilieren, wenn ich das über IntelliJ machen ==
10
11 Bitte beachten, ob das Lombok-Plugin installiert ist. Bei Ultimate ist es dabei.
12
13
14 == Ich bekomme beim Starten des Clients die Meldung, dass die notwendigen JavaFX Componenten fehlen ==
15
16 Wichtig ist es (dann) hier, das Klasse Main und nicht die Klasse ClientApp zum Starten zu verwenden.
17
18
19 == Ich habe keine vordefinierten Nutzer test1, test2 etc. ==
20
21 Dann ist das Spring-Profil nicht geladen. Siehe Einrichtung (entweder mit dem Spring-Plugin, das sollte man auch nachinstallieren können) oder über die Umgebungsvariable.
22
23
24 == Ich bekomme bei Maven komische Fehlermeldungen ==
25
26 === mit JavaFX ===
27
28 sowas wie:
29
30 [ERROR] Failed to execute goal on project client: Could not resolve dependencies for project de.uol.swp:client:jar:2.0-SNAPSHOT
31 [ERROR] dependency: org.openjfx:javafx-controls:jar:win-x86:21.0.7 (compile)
32 [ERROR]         org.openjfx:javafx-controls:jar:win-x86:21.0.7 was not found in [[https:~~/~~/repo.maven.apache.org/maven2>>url:https://repo.maven.apache.org/maven2]] during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of central has elapsed or updates are forced
33
34 Bitte einmal schauen, welche Java-Version auf der Shell ist (java -version). Vielleicht ist noch mal ein alte Version irgendwo auf dem Rechner installiert und wird verwendet. **Es sollte eine Java-Version mindestens der Version 21 verwendet werden.**
35
36 === mit Invalid Target ===
37
38 [ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.13.0:compile (default-compile) on project client: Fatal error compiling: error: invalid target release: 21 -> [Help 1]
39
40 Bitte einmal schauen, welche Java-Version auf der Shell ist (java -version). Vielleicht ist noch mal ein alte Version irgendwo auf dem Rechner installiert und wird verwendet. **Es sollte eine Java-Version mindestens der Version 21 verwendet werden.**
41
42
43 === Probleme mit Maven oder IntelliJ ===
44
45 Falls IntelliJ nach dem Klonen des Repositories nicht alle Abhängigkeiten oder Klassen erkennt, überprüfen Sie bitte folgende Punkte:
46
47 1. **Java-Version:** Das Basisprojekt benötigt mindestens Java 21. Kontrollieren Sie mit java -version und mvn -version, welche Versionen verwendet werden.
48 1. **IntelliJ-Projekt:** Öffnen Sie das gesamte Projekt mit der übergeordneten pom.xml, nicht nur das Server- oder Client-Verzeichnis.
49 1. **Maven-Konfiguration:** Überprüfen Sie unter //Settings → Build Tools → Maven//, ob Maven mit einem passenden JDK ausgeführt wird.
50 1. **Maven aktualisieren:** Öffnen Sie das Maven-Toolfenster und wählen Sie //Reload All Maven Projects//.
51 1. (((
52 **Projekt bauen:** Öffnen Sie ein Terminal im Hauptverzeichnis des Projekts und führen Sie folgenden Befehl aus:
53
54 mvn -U clean install -DskipTests
55 )))
56 1. **Generierte Klassen:** Stellen Sie sicher, dass die durch OpenAPI generierten Java-Klassen unter target/generated-sources vorhanden sind und von IntelliJ erkannt werden.
57 1. **Lombok:** Prüfen Sie, ob das Lombok-Plugin aktiviert ist und Annotation Processing korrekt funktioniert.
58 1. **Server starten:** Starten Sie die Klasse ServerApp im Server-Modul. Überprüfen Sie bei Problemen die Java-Version und die Startkonfiguration.
59
60 **Hinweis:** Wenn Maven im Terminal erfolgreich durchläuft, IntelliJ aber weiterhin Fehler anzeigt, liegt das Problem häufig an der IntelliJ-Projektkonfiguration und nicht an den Abhängigkeiten selbst.
61
62 Sollte der Server anschließend weiterhin nicht starten, teilen Sie bitte die erste aussagekräftige Fehlermeldung aus dem Run-Fenster beziehungsweise den ersten relevanten Caused by-Eintrag mit.
63
64
65 = Siehe auch =
66
67 * [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
68 * [[Glossar>>doc:Main.Glossar.WebHome]]