Was bedeutet der PrimeFaces-Fehler java.lang.IllegalStateException: UT000002: The response has already been started?

Die Fehlermeldung `java.lang.IllegalStateException: UT000002: The response has already been started` tritt häufig in Java-Webanwendungen auf, die mit JSF (z.B. PrimeFaces) und einem Servlet-Container wie WildFly oder Undertow laufen. Sie bedeutet, dass versucht wurde, auf die HTTP-Response zuzugreifen oder sie zu verändern, nachdem bereits ein Teil der Antwort an den Client gesendet wurde. **Typische Ursachen:** 1. **Mehrfaches Weiterleiten oder Umleiten:** Es wird z.B. `ExternalContext.redirect()` oder `RequestDispatcher.forward()` mehrmals oder nach dem Schreiben in die Response aufgerufen. 2. **Schreiben in die Response nach Abschluss:** Es wird nach dem Schließen des OutputStreams oder Writers noch versucht, Daten zu schreiben. 3. **Fehlerhafte JSF-Phasen:** Methoden, die die Response beeinflussen, werden in einer falschen JSF-Phase aufgerufen. **Beispielproblem:** ```java ExternalContext ec = FacesContext.getCurrentInstance().getExternalContext(); ec.redirect("somePage.xhtml"); // ... später im Code ec.redirect("anotherPage.xhtml"); // Fehler! ``` **Lösungsansätze:** - **Prüfe, ob die Response bereits abgeschlossen ist:** Vor dem Zugriff auf die Response kann geprüft werden, ob sie noch offen ist: ```java FacesContext context = FacesContext.getCurrentInstance(); if (!context.getResponseComplete()) { context.getExternalContext().redirect("somePage.xhtml"); context.responseComplete(); } ``` - **Vermeide mehrfaches Weiterleiten/Umleiten:** Stelle sicher, dass `redirect()` oder ähnliche Methoden nur einmal pro Request aufgerufen werden. - **Fehler im Stacktrace prüfen:** Analysiere den Stacktrace, um die genaue Stelle im Code zu finden, an der nach dem Start der Response noch darauf zugegriffen wird. - **JSF-Phasen beachten:** Response-beeinflussende Methoden sollten in der richtigen JSF-Phase (meist nach der Invoke Application-Phase) aufgerufen werden. **Weitere Infos:** - [PrimeFaces Dokumentation](https://primefaces.org/documentation/) - [JSF ExternalContext API](https://jakarta.ee/specifications/faces/3.0/apidocs/jakarta.faces/jakarta/faces/context/ExternalContext.html) - [WildFly Undertow Fehlercodes](https://issues.redhat.com/browse/UNDERTOW-702) **Zusammenfassung:** Die Exception bedeutet, dass die HTTP-Antwort bereits begonnen wurde und keine weiteren Änderungen mehr erlaubt sind. Überprüfe deinen Code auf mehrfaches Weiterleiten, Umleiten oder Schreiben in die Response nach deren Abschluss.