M1 macOS通过LaunchDaemon执行Cypress定时任务遇npx命令未找到问题

核心原因 #

LaunchDaemon运行时的环境变量和你日常登录终端的环境不一样，默认PATH里没有node/npm/npx的安装路径，所以会提示找不到命令。完全可以用LaunchDaemon或LaunchAgent运行npm/npx命令，只要处理好环境变量即可。

具体解决步骤 #

方法1：直接使用npx的绝对路径 #

1. 打开终端，输入which npx，获取npx的绝对路径。M1 Mac上用Homebrew安装的话，路径一般是/opt/homebrew/bin/npx；如果用nvm管理node，路径可能是/Users/codyzzd/.nvm/versions/node/vxx.x.x/bin/npx（把vxx.x.x换成你实际的node版本）。
2. 修改你的shell脚本（shponto.sh），把npx替换成这个绝对路径。比如原命令：

   npx cypress run --spec "xxx"
   

   改成：

   /opt/homebrew/bin/npx cypress run --spec "xxx"
   

方法2：在脚本开头手动设置PATH #

在shell脚本最顶部添加PATH环境变量配置，把包含npx的路径加入：

#!/bin/bash
# 配置PATH，涵盖node/npm的安装路径
export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
# 如果用nvm，还需加载nvm配置（可选）
# source /Users/codyzzd/.nvm/nvm.sh

# 切换到项目目录
cd /Users/codyzzd/你的项目路径
# 正常调用npx
npx cypress run --spec "cypress/e2e/指定测试用例.js"

方法3：在plist中配置环境变量 #

也可以直接在LaunchDaemon的plist配置文件里添加EnvironmentVariables键，设置PATH：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- 其他原有配置 -->
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
    </dict>
    <!-- 其他原有配置 -->
</dict>
</plist>

额外注意事项 #

1. 给shell脚本添加执行权限：在终端运行chmod +x /Users/codyzzd/shponto.sh。
2. LaunchDaemon与LaunchAgent的选择：
   • LaunchDaemon是系统级服务，开机即运行，无需用户登录，适合无UI的headless测试任务。
   • LaunchAgent是用户级服务，仅当你登录系统后才运行，如果测试需要调用UI界面，建议使用这个。
3. plist文件权限要正确：如果是LaunchDaemon，文件需放在/Library/LaunchDaemons/目录下，权限设置为root:wheel，可通过命令sudo chown root:wheel /Library/LaunchDaemons/你的plist文件名.plist修改。
4. 加载/卸载plist的命令：
   • 加载：sudo launchctl load /Library/LaunchDaemons/你的plist文件名.plist
   • 卸载：sudo launchctl unload /Library/LaunchDaemons/你的plist文件名.plist

内容的提问来源于stack exchange，提问作者Bruno Gonçalves