LaunchAgent po migraci Macu tiše končí s exit 0 – cesty v plistu vedou přes symlink starého domovského adresáře
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Lokální Node služba (dashboard na 127.0.0.1:<port>) po přenosu profilu na nový Mac neodpovídá. launchctl print gui/$UID/<label> ukazuje state = spawn scheduled, runs = 1244, last exit code = 0, job state = exited. Do StandardOutPath/StandardErrorPath se nic nového nezapisuje. Ruční spuštění stejného příkazu v terminálu běží normálně. Ostatní agenti, kteří službu volají, hlásí „API na výchozím portu nedostupné“.
Root cause
Sekce “Root cause”Nový Mac má jiné uživatelské jméno; kvůli zpětné kompatibilitě vznikl root-owned symlink /Users/<stare-jmeno> → /Users/<nove-jmeno>. Plist LaunchAgentu ale stále obsahoval staré cesty:
<string>/Users/<stare-jmeno>/Projects/<sluzba>/dist/src/main.js</string><key>WorkingDirectory</key><string>/Users/<stare-jmeno>/Projects/<sluzba></string><key>StandardOutPath</key><string>/Users/<stare-jmeno>/Library/Application Support/<sluzba>/service.stdout.log</string>V shellu symlink funguje, launchd však při spawnování job přes tento symlink nespustí (log soubory ani pracovní adresář nedokáže otevřít) a výsledek zaznamená jako okamžitý exit 0 – bez chybové hlášky v logu služby. KeepAlive pak job spawnuje donekonečna (throttling ~10 s), takže na první pohled „běží“.
Fix
Sekce “Fix”cp ~/Library/LaunchAgents/<label>.plist /tmp/<label>.plist.baksed -i '' 's#/Users/<stare-jmeno>/#/Users/<nove-jmeno>/#g' ~/Library/LaunchAgents/<label>.plistplutil -lint ~/Library/LaunchAgents/<label>.plistlaunchctl bootout gui/$(id -u)/<label>launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/<label>.plistlaunchctl print gui/$(id -u)/<label> | grep -E 'state|pid|last exit' # state = runningPo opravě runs = 1, last exit code = (never exited), port odpovídá 200.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -l "/Users/<stare-jmeno>" ~/Library/LaunchAgents/*.plist; vlaunchctl printkombinace vysokéhoruns,last exit code = 0a logu bez nových řádků. - Anti-pattern: absolutní cesty na domovský adresář v plistech + spoléhání na symlink po migraci; diagnostika jen podle „ruční start funguje“.
- Lepší přístup: cesty v plistech generovat ze skutečného
$HOMEpři instalaci služby (instalační skript), po migraci spustit kontrolní skript nad všemi LaunchAgenty; log služby mimo symlinkované cesty.
Sister bugs / související
Sekce “Sister bugs / související”- Služby po migraci mohou narazit i na změnu verze Node (např. modul
node:sqliteje až od Node 22.5) – ověřit, kterým binárkem plist službu spouští.