排查macOS服务加载失败需聚焦launchd日志，用log show命令提取com.apple.xpc.launchd子系统中含failed、invalid、denied、timeout等关键词的错误事件，并结合plist验证、权限检查及launchctl手动加载定位根因。
排查 macos 系统服务加载失败，关键在于定位 launchd 启动过程中被拒绝、超时或配置异常的服务日志。log show 命令可直接读取 unified logging 数据库中结构化的启动事件，比翻查传统文本日志更精准、更及时。
聚焦 launchd 和系统服务子系统
系统服务由 launchd 统一管理，其加载行为（如 bootstrap 失败、plist 解析错误、权限不足）会记录在特定子系统下。执行以下命令可集中提取核心线索：
-
查看所有 launchd 相关错误事件：
log show --predicate '(subsystem == "com.apple.xpc.launchd" OR process == "launchd") AND (level >= error)' --last boot -
筛选服务加载失败的典型关键词：
log show --predicate '(subsystem == "com.apple.xpc.launchd") AND (eventMessage contains[c] "failed" OR eventMessage contains[c] "invalid" OR eventMessage contains[c] "denied" OR eventMessage contains[c] "timeout")' --last boot -
只看用户级服务（避免内核干扰）：
log show --predicate 'senderImagePath contains "launchd" AND eventMessage contains[c] "user"' --last boot --info
识别常见服务加载错误模式
返回日志中需重点关注以下几类明确提示：
- “Service could not be loaded” 或 “bootstrap failed”：通常因 plist 文件语法错误、路径不存在或权限不正确（如非 root 服务放在 /Library/LaunchDaemons 下）；
-
“Invalid property list”：LaunchDaemon/LaunchAgent 的 .plist 文件 XML 格式损坏，可用
plutil -lint /path/to/your.plist验证； - “Operation not permitted” 或 “Permission denied”：macOS 安全策略（如 SIP 或 TCC）阻止了服务访问必要资源，尤其在 macOS 12+ 中常见；
- “Job is already running” 或 “Throttled”：服务重复注册或启动频率超限，可能因多个 plist 冲突或 KeepAlive 配置不当。
关联进程与配置文件定位根因
单条日志常含 process、senderImagePath 或 eventMessage 中的路径线索。例如日志出现：
Failed to bootstrap path: path="/Library/LaunchDaemons/com.example.backup.plist"
就应立即检查该路径下 plist 是否存在、是否可读、是否签名有效（若启用公证要求），并用以下命令验证加载状态：
- 查看当前已加载的服务列表：
launchctl list | grep example - 尝试手动加载并捕获即时反馈：
sudo launchctl load /Library/LaunchDaemons/com.example.backup.plist - 查看该服务的详细配置：
launchctl print system/com.example.backup（需已加载）
