macos服务启动失败需综合排查权限、配置、依赖及系统完整性，典型错误码包括78（plist语法或路径问题）、113（权限不足）、255（程序异常退出），“could not find and/or execute program”提示路径错误；plist须语法正确、label唯一、避免用户变量；ventura后还需关注签名、hardened runtime、文件权限与架构匹配；调试应结合launchctl命令、日志分析及必要时临时禁用sip。
macos 系统服务启动加载失败，通常不是单一错误代码的问题，而是由权限、配置、依赖或系统完整性等多层因素共同导致。直接看报错提示（如 launchd 错误、plist 加载失败、exit code 78/113/255 等）只是表象，关键在于定位服务启动链中的断点。
launchd 服务加载失败的典型错误码与含义
macOS 使用 launchd 管理后台服务，其日志和退出码能快速反映问题根源：
- Exit code 78：plist 文件语法错误或路径无效（如 ProgramArguments 指向不存在的二进制，或 WorkingDirectory 不合法）
- Exit code 113：权限不足——常见于服务需 root 权限但未以 LaunchDaemons 运行，或可执行文件缺少 +x 权限
- Exit code 255：脚本或二进制本身异常退出（如 Python 脚本抛出未捕获异常、依赖库缺失）
- “Could not find and/or execute program”：launchd 找不到指定的可执行文件，注意检查路径是否含空格、是否用了相对路径、是否拼写错误
配置文件（.plist）常见损坏点
LaunchAgent 或 LaunchDaemon 的 plist 是服务启动的“说明书”，一处写错就加载失败：
- 使用 Property List Editor 或 xcode-select --install 后用 plutil -lint xxx.plist 验证语法
- 确保
Label值唯一且不含非法字符（推荐用反向域名格式，如 com.example.myserver） - 若服务依赖网络或用户会话，检查
RunAtLoad、KeepAlive、StartOnMount等键值是否合理 - 避免在 LaunchDaemons 中引用
$HOME或~—— 系统级服务无用户环境变量
权限与签名问题（尤其 macOS 14+ / Apple Silicon）
从 Ventura 开始，Apple 对后台服务施加更严格的 Gatekeeper 和 Hardened Runtime 限制：
- 确认可执行文件已通过 codesign --verify --verbose=4 /path/to/binary 验证签名有效
- 若为自研工具，需启用
com.apple.security.cs.allow-jit和com.apple.security.cs.disable-library-validation（仅开发阶段） - 检查文件所有权：sudo chown root:wheel /Library/LaunchDaemons/com.example.service.plist，且权限设为 644
- Apple Silicon 设备上，确保二进制架构匹配（arm64），运行 file /path/to/binary 确认
调试与实时诊断方法
不要只看一次性报错，要观察服务整个生命周期：
- 加载后立即检查：launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.example.plist（用户级）或 sudo launchctl bootstrap system /Library/LaunchDaemons/com.example.plist
- 查看加载状态：launchctl list | grep example，再查详细日志：log show --predicate 'subsystem == "com.example"' --last 5m
- 手动触发启动并捕获输出：launchctl kickstart -k system/com.example，随后立刻运行 console --predicate 'senderImagePath CONTAINS "com.example"'
- 临时禁用 SIP（仅调试需要）：csrutil disable（重启后生效），验证是否因系统保护机制拦截
