Okamžitý restart LaunchAgentu může skončit chybou bootstrap
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Instalační skript provede launchctl bootout a hned poté launchctl bootstrap. Druhý příkaz občas skončí obecnou vstupně-výstupní chybou. Ruční opakování stejného bootstrap příkazu o chvíli později projde bez změny plist souboru.
Root cause
Sekce “Root cause”Odstranění jobu z launchd domény není vždy synchronní s okamžikem návratu bootout. Krátké okno může přetrvat i poté, co launchctl print už původní job nenajde. Jednorázový bootstrap proto zamění přechodný stav launchd za trvalou chybu konfigurace.
launchctl bootout "$DOMAIN/$LABEL" 2>/dev/null || truelaunchctl bootstrap "$DOMAIN" "$PLIST" # přechodně může selhatFix
Sekce “Fix”Samotný bootstrap má bounded retry. Počet pokusů i prodleva jsou pevné; nekonečná smyčka není přípustná. Po vyčerpání limitu skript vrátí odlišný chybový kód a službu neprohlásí za spuštěnou.
attempts=20while ! launchctl bootstrap "$DOMAIN" "$PLIST"; do attempts=$((attempts - 1)) [ "$attempts" -gt 0 ] || exit 3 sleep 0.1doneJak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Hledej instalační skripty s
bootoutnásledovaným jedinýmbootstrapbez bounded retry. - Anti-pattern: Pevný dlouhý
sleepnebo nekonečné opakování bez rozlišení trvalé chyby. - Lepší přístup: Krátký bounded retry pouze kolem přechodně selhávající operace; plist nejdřív samostatně ověřit pomocí
plutil.
Sister bugs / související
Sekce “Sister bugs / související”Podobný vzor se objevuje při restartu systemd jednotek nebo výměně socket listeneru: řídicí příkaz se vrátí dřív, než je interní životní cyklus plně uzavřen. Oprava musí být omezená počtem pokusů a nesmí maskovat trvalou chybu konfigurace.