Warum Wails-Apps in Production abstürzen und wie man sie auf Low-Level-Ebene steuert
makedreamJuly 26, 2026
0
Computing/Software
Comments (0)
Log in to leave a comment
No posts yet
makedreammakedreamLog in to leave a comment
No posts yet
Beim Entwickeln von Desktop-Apps mit Go ist Wails eine attraktive Wahl. Da es im Gegensatz zu Electron nicht den gesamten Chromium-Browser verpackt, ist es leicht und schnell. Sobald man jedoch die Tutorials verlässt und einen echten Dienst aufbauen möchte, stößt man schnell an Grenzen. Der CGo-Speicher beginnt zu lecken, und die WebViews verhalten sich unter Windows und macOS unterschiedlich.
Für Backend-Entwickler ohne Erfahrung mit C/C++ oder Objective-C ist dieser Punkt eine schier unüberwindbare Hürde. Wenn man die Speicherlecks und die OS-spezifische WebView-Fragmentierung, die sich hinter den glänzenden Beispielen der offiziellen Dokumentation verbergen, nicht in den Griff bekommt, ist ein Production-Deployment unmöglich.
Der häufigste Denkfehler bei der Verwendung von CGo ist die Erwartung, dass der Garbage Collector von Go sich auch um den C-Bereich kümmert. Natürlich tut er das nicht. Speicher, der mit C.CString oder C.malloc zugewiesen wurde, verbleibt im C-Bereich und frisst Speicher, bis die Anwendung stirbt.
Auch beim Übergeben von Go-Slices an C-Funktionen ist Vorsicht geboten. Die Übergabe der Adresse des Slice-Headers selbst führt zu Speicherbeschädigung. Es ist nur sicher, die tatsächliche Adresse des ersten Elements zu übergeben: unsafe.Pointer(&slice[0]). Beim Aufruf von Objective-C-Code unter macOS sollte man sich nicht blind auf ARC verlassen. Objekte, die innerhalb der CGo-Thread-Schleife erstellt werden, sammelt sich kontinuierlich im NSAutoreleasePool an. Man muss sie explizit mit einem @autoreleasepool { ... }-Block umschließen, um sie sofort zu bereinigen.
In einer Windows-Umgebung muss man den CGo-Compiler (MinGW) nicht zwangsläufig als Altlast mitführen. Man kann ohne CGo-Overhead DLLs direkt über das syscall-Paket aufrufen. Der Code zum Aktivieren des Dark Modes durch Laden der dwmapi.dll ist einfacher als gedacht.
`go
// system_windows.go
//go:build windows
package native
import (
"syscall"
"unsafe"
)
var (
modDwmApi = syscall.NewLazyDLL("dwmapi.dll")
procDwmSetWindowAttribute = modDwmApi.NewProc("DwmSetWindowAttribute")
)
const DWMWA_USE_IMMERSIVE_DARK_MODE = 20
func SetWindowsDarkMode(hwnd uintptr, enable bool) error {
var val int32
if enable {
val = 1
}
ret, _, err := procDwmSetWindowAttribute.Call(
hwnd,
uintptr(DWMWA_USE_IMMERSIVE_DARK_MODE),
uintptr(unsafe.Pointer(&val)),
uintptr(unsafe.Sizeof(val)),
)
if ret != 0 {
return err
}
return nil
}
`
Beim Erstellen eines nativen Steuerungsmoduls definiert man zuerst eine gemeinsame Schnittstelle (system_interface.go). Anschließend fügt man die Objective-C-Logik in die macOS-Implementierung (system_darwin.go) zusammen mit der //go:build darwin-Direktive ein und schreibt für die Windows-Implementierung Reines-Go-Syscall mit //go:build windows, um beide sauber zu trennen. Wenn man sich einfach angewöhnt, direkt nach der CGo-Allokation ein defer C.free anzufügen, gehören App-Abstürze durch Speicherlecks der Vergangenheit an.
Wails greift auf die im Betriebssystem bereits installierte WebView zurück. macOS nutzt WebKit (Safari), Windows nutzt WebView2 (Chromium). Im Gegenzug dafür, dass die Binärgröße auf etwa 15 MB schrumpft, muss man sich selbst um die Fragmentierung zwischen den Browser-Engines kümmern.
Wenn man beispielsweise in einem rahmenlosen Fenster ohne Titelleiste einen Ziehbereich (Drag Area) festlegt, reicht unter WebView2 --wails-draggable: drag aus. Unter WebKit bewegt sich das Fenster jedoch nicht, wenn man nicht zusätzlich -webkit-app-region: drag explizit angibt.
Auch bei der Ereignisverarbeitung kann es zu Problemen kommen. Wenn man in einer Go-Goroutine tausende Male pro Sekunde runtime.EventsEmit aufruft, schreit der einzelne UI-Thread der WebView auf und der Bildschirm friert ein. Im Backend muss ein Puffer eingerichtet werden, der Ereignisse in einem 60-fps-Intervall (ca. 16 ms) drosselt (Throttling). Auch Missgeschicke im Frontend, bei denen der Benutzer durch Drücken von F5 den Zustand löscht oder das Kontextmenü per Rechtsklick öffnet, müssen durch globale Patches verhindert werden.
`typescript
// eventPatch.ts
export function applyGlobalUIFixes() {
window.addEventListener('contextmenu', (e: MouseEvent) => {
const target = e.target as HTMLElement;
if (target.tagName !== 'INPUT' && target.tagName !== 'TEXTAREA') {
e.preventDefault();
}
});
window.addEventListener('keydown', (e: KeyboardEvent) => {
const isMac = navigator.platform.toUpperCase().indexOf('MAC') >= 0;
const modifier = isMac ? e.metaKey : e.ctrlKey;
if (e.key === 'F5' || (modifier && e.key.toLowerCase() === 'r')) {
e.preventDefault();
e.stopPropagation();
}
});
}
`
Im CSS trägt man die Drag-Eigenschaften für beide Engines gleichzeitig ein und führt applyGlobalUIFixes() am Einstiegspunkt der App (main.ts oder App.tsx) aus. Auf der Backend-Seite fügt man dem Event-Emitter einen Throttling-Timer hinzu. Mit solchen Vorkehrungen lässt sich das Fehlverhalten, das durch OS-spezifische WebView-Eigenheiten entsteht, größtenteils beheben.
Eine Wails-App verbraucht im Normalbetrieb etwa 35 MB bis 50 MB RAM. Im Vergleich zu Electron, das über 200 MB frisst, ist das sehr sparsam. Das Problem tritt auf, wenn große Dateien oder Binärdaten an das Frontend übertragen werden.
Wenn man 50 MB große Daten über die standardmäßig bereitgestellte JSON-RPC-Bindung überträgt, schießt der RAM-Verbrauch während der JSON-Serialisierung kurzzeitig auf über 180 MB hoch. Um dieses Phänomen zu vermeiden, sollte man die Option AssetServer.AssetsHandler nutzen, um ein benutzerdefiniertes HTTP-Streaming zu implementieren. Durch die Übertragung der Daten im Zero-Copy-Verfahren ohne Speicherkopierung kann man den Speicherverbrauch im Leerlauf sowie bei Arbeitslasten stabil im Bereich von 22 MB bis 30 MB halten.
Auch auf die Umgebungen der Windows-Benutzer muss reagiert werden. Für Clients, auf denen die WebView2-Runtime nicht installiert ist, fügt man beim Build das Flag -webview2 download hinzu, um den Bootstrapper gleich mit einzupacken.
`yaml
name: Multiplatform Release Build
on:
push:
tags:
- 'v*'
jobs:
build:
runs-on: ${{ matrix.os }}
strategy:
matrix:
include:
- os: macos-latest
platform: darwin/universal
output_name: OptimizedApp-macOS-Universal
- os: windows-latest
platform: windows/amd64
output_name: OptimizedApp-Windows-Installer
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
with:
go-version: '1.22'
- uses: actions/setup-node@v4
with:
node-version: '20'
- name: Install Wails
run: go install github.com/wailsapp/wails/v2/cmd/wails@latest
- name: Build macOS Universal Binary
if: runner.os == 'macOS'
run: wails build -platform darwin/universal -clean
- name: Build Windows Installer
if: runner.os == 'Windows'
run: |
choco install nsis -y
wails build -platform windows/amd64 -nsis -webview2 download -clean
`
In der main.go verbindet man einen benutzerdefinierten http.Handler mit AssetServer.AssetsHandler, um Speicherpeaks bei großen Datenmengen zu verhindern. Anschließend fügt man die obige Pipeline in .github/workflows/release.yml ein. Jedes Mal, wenn ein Tag gepusht wird, werden eine macOS Universal Binary und eine Windows NSIS-Installationsdatei erstellt und zu den GitHub Releases hochgeladen.
Wenn man die Speicherverwaltung auf Low-Level-Ebene selbst in die Hand nimmt und die Unterschiede der WebView-Engines im Code abfängt, kann man auch mit Wails extrem solide Desktop-Anwendungen bauen.