Přeskočit na obsah

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’;

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é“.

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ěží“.

Terminál
cp ~/Library/LaunchAgents/<label>.plist /tmp/<label>.plist.bak
sed -i '' 's#/Users/<stare-jmeno>/#/Users/<nove-jmeno>/#g' ~/Library/LaunchAgents/<label>.plist
plutil -lint ~/Library/LaunchAgents/<label>.plist
launchctl bootout gui/$(id -u)/<label>
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/<label>.plist
launchctl print gui/$(id -u)/<label> | grep -E 'state|pid|last exit' # state = running

Po 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; v launchctl print kombinace vysokého runs, last exit code = 0 a 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 $HOME př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:sqlite je až od Node 22.5) – ověřit, kterým binárkem plist službu spouští.
Přidal aiarchitekt.cz · 12. 11. 2026 1:00
Provozuje aiarchitekt.cz