launchd登录脚本无法正常运行问题求助

我之前踩过不少launchd脚本不运行的坑，给你整理了一套逐步排查的方法，应该能帮你定位并解决问题：

1. 先确认脚本本身没问题 #

launchd脚本跑不起来，很多时候是脚本自身的问题，先把这个排除：

• 给脚本添加可执行权限：运行 chmod +x /Users/Shared/fooscript.sh
• 手动执行脚本测试：直接在终端跑 /Users/Shared/fooscript.sh，如果手动都报错，先解决脚本的语法错误、依赖缺失（比如用到的命令不在默认PATH里）等问题。

2. 完善plist配置的必要项 #

你的plist只有基础配置，很多关键项缺失会导致脚本无法正常运行，建议补充以下内容：

• 工作目录：launchd默认的工作目录是根目录/，如果脚本里用到相对路径，肯定会出问题，加上：

  <key>WorkingDirectory</key>
  <string>/Users/Shared</string>
  

• 环境变量：launchd的默认PATH非常窄（只有/usr/bin:/bin:/usr/sbin:/sbin），如果脚本用到的命令在其他路径（比如/usr/local/bin），需要手动指定：

  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
  </dict>
  

• 日志输出：添加日志路径，方便后续排查错误：

  <key>StandardOutPath</key>
  <string>/Users/Shared/foo_out.log</string>
  <key>StandardErrorPath</key>
  <string>/Users/Shared/foo_err.log</string>
  

3. 检查launchd的加载状态 #

确保plist放在正确的位置（用户登录级别的agent要放在~/Library/LaunchAgents/目录下），然后执行以下操作：

• 先卸载旧的配置（如果之前加载过）：launchctl unload ~/Library/LaunchAgents/com.foo.foo1.plist
• 重新加载配置：launchctl load ~/Library/LaunchAgents/com.foo.foo1.plist
• 验证是否加载成功：launchctl list | grep com.foo.foo1，如果能看到对应的条目，说明加载成功；如果无输出，可能是plist有语法错误
• 检查plist语法：plutil -lint ~/Library/LaunchAgents/com.foo.foo1.plist，有语法错误会直接提示。

4. 系统权限与隐私设置 #

如果脚本涉及访问文件、系统资源等操作，可能被系统权限拦截：

• 前往「系统设置-隐私与安全性」，检查是否有相关的权限请求提示，比如“完全磁盘访问”权限，给对应的进程或脚本授权
• 对于 macOS Ventura 及以上版本，部分脚本可能需要在「系统设置-通用-登录项」里添加为允许的登录项。

5. 查看系统日志定位具体错误 #

如果以上步骤都没解决，直接看launchd的日志找原因：

• 运行命令：log show --predicate 'process == "launchd" AND message contains "com.foo.foo1"' --info
• 日志里会明确显示脚本启动失败的原因，比如权限不足、找不到执行文件、依赖命令不存在等。

内容的提问来源于stack exchange，提问作者Zange