Launchd触发Python脚本失败：终端可运行但Launchctl返回状态码127

这个问题我之前也踩过坑，核心原因其实很好理解：launchd运行时的环境变量和你终端里的完全不一样！它不会加载你的shell配置文件（比如.zshrc、.bashrc），默认的PATH只包含系统自带的几个目录（比如/bin:/usr/bin），而你的python3大概率安装在其他位置（比如Homebrew的/opt/homebrew/bin或者/usr/local/bin），导致launchd找不到它，直接抛出了127错误。

给你几个靠谱的解决方案，按优先级排序：

1. 用Python3的绝对路径替换shebang里的python3 #

这是最直接省心的办法：

• 先在终端里执行 which python3，得到你的python3绝对路径，比如M1/M2 Mac可能是/opt/homebrew/bin/python3，Intel Mac可能是/usr/local/bin/python3
• 把你脚本开头的shebang行从#!/usr/bin/env python3改成这个绝对路径，比如：

  #!/opt/homebrew/bin/python3
  

• 同时确保你的.plist里的program字段写的是脚本的完整绝对路径（比如/Users/你的用户名/Projects/your_script.py），绝对不能用相对路径。

2. 在.plist里手动设置PATH环境变量 #

如果你不想修改脚本的shebang，可以直接在.plist里给launchd指定包含python3的PATH：
在你的plist文件中添加这段配置：

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

把里面的路径换成你实际的python3所在目录（就是刚才which python3得到的路径的目录部分），这样launchd就能准确定位到python3了。

3. 确认脚本的基础执行权限 #

别漏了最基础的检查：

• 给脚本添加可执行权限：chmod +x your_script.py
• 反复核对.plist里的program路径是否完全正确，复制到终端里能直接运行的那种绝对路径才靠谱。

调试小技巧 #

可以把脚本的输出和错误重定向到文件，方便排查问题：
在.plist里加上：

<key>StandardOutPath</key>
<string>/tmp/script_output.log</string>
<key>StandardErrorPath</key>
<string>/tmp/script_error.log</string>

加载plist后（launchctl load ~/Library/LaunchAgents/your_service.plist），手动触发测试：launchctl start com.yourname.yourservice，然后去查看这两个日志文件，就能清晰看到问题出在哪里了。

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