rinkplanner/docs/findings-2026-11-12-headless-crash.md
torsten e2dba11e91 fix: Beim Beenden alle Worker-Threads einsammeln
Der exportierte Build stürzte mit SIGSEGV ab, wenn er direkt nach dem
Start beendet wurde (--quit-after 5, Fenster schließen): Der automatische
Update-Check lief noch im Hintergrund-Thread, _exit_tree sammelte ihn
aber nicht ein. Ohne Netzwerk trat der Fehler nicht auf.

- _exit_tree setzt jetzt CloudHttp.request_cancel() und wartet auf
  Update-, OAuth-, Sync- und Hub-Thread.
- CloudHttp bricht seine Warteschleifen bei cancel_requested sofort ab,
  statt bis zum Timeout weiterzulaufen.
- Der Update-Check läuft headless nicht mehr (dort sinnlos).

check_export.sh bleibt bei --quit-after 5 und prüft damit weiter, dass
der Export sauber beendet. Ursache und Nachweis:
docs/findings-2026-11-12-headless-crash.md
2026-11-12 23:46:13 +01:00

49 lines
2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Headless-Crash beim Beenden des Exports
Stand: 2026-11-12. Betrifft `./tools/check_export.sh` und jedes vorzeitige
Beenden der App (Fenster schließen direkt nach dem Start).
## Symptom
Der exportierte Linux-Build beendet sich mit `SIGSEGV` (Status 139), sobald
er mit `--headless --quit-after 5` gestartet wird. Der Editor-Build und die
Tests laufen headless fehlerfrei; mit Display (Vulkan) startet derselbe
Export normal.
Der Crash trat schon vor der Übersetzungsarbeit auf (geprüft mit einem
Worktree auf `9819311`), ist also kein Regress daraus.
## Ursache
Nicht die Texturen, sondern der **automatische Update-Check**:
- Im exportierten Build startet `_ready()` über `_start_update_check(false)`
einen `Thread`, der per `CloudHttp` den Versions-Endpunkt abruft.
- `--quit-after 5` beendet die App nach wenigen Frames, während der Thread
noch in der HTTPS-Anfrage hängt.
- Der bisherige `_exit_tree()` sammelte nur OAuth-, Sync- und Hub-Threads ein,
**nicht** den Update-Thread. Die Engine fuhr den Prozess herunter, während
der Thread noch lief und Speicher benutzte → `SIGSEGV` im Worker-Thread.
Nachweis: Mit `unshare -rn` (ohne Netzwerk) endet derselbe Build mit
`--quit-after 5` sauber; mit Netzwerk stürzt er ab. Die Schwelle lag auf
diesem Rechner zwischen 20 und 25 Frames (ab dann war der Thread fertig).
## Fix
- `_exit_tree()` (Whiteboard-Controller) setzt jetzt zusätzlich
`CloudHttp.request_cancel()` und sammelt **alle** Threads ein
(Update, OAuth, Sync, Hub).
- `CloudHttp` prüft in allen Warteschleifen ein statisches
`cancel_requested` und bricht sofort mit „Abgebrochen.“ ab, statt bis zum
Timeout (20–300 s) weiterzulaufen.
- Der Update-Check läuft headless gar nicht mehr
(`DisplayServer.get_name() == "headless"`), dort ist er sinnlos.
`check_export.sh` bleibt bei `--quit-after 5` und deckt damit weiterhin ab,
dass beim Beenden alle Threads eingesammelt werden.
## Test
`tests/run_sync_tests.gd` prüft, dass eine abgebrochene Anfrage sofort
zurückkehrt und den Fehler „Abgebrochen.“ meldet.