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
This commit is contained in:
parent
b24ce9f4fb
commit
e2dba11e91
5 changed files with 115 additions and 9 deletions
49
docs/findings-2026-11-12-headless-crash.md
Normal file
49
docs/findings-2026-11-12-headless-crash.md
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
# 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue