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
2 KiB
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)einenThread, der perCloudHttpden Versions-Endpunkt abruft. --quit-after 5beendet 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 →SIGSEGVim 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ätzlichCloudHttp.request_cancel()und sammelt alle Threads ein (Update, OAuth, Sync, Hub).CloudHttpprüft in allen Warteschleifen ein statischescancel_requestedund 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.