cfexecute执行Node脚本提示找不到puppeteer模块但cmd运行正常

根因说明 #

cmd下执行正常但cfexecute执行报错的核心原因是ColdFusion服务的运行环境未加载到配置的NODE_PATH变量：
你配置的NODE_PATH包含Administrator用户变量，而ColdFusion服务默认以Local System内置账户运行，不会加载Administrator的用户环境变量，也可能存在服务启动时未同步最新系统变量的情况。

验证方法 #

先执行测试脚本确认环境变量差异，脚本内容如下：

console.log(module.paths);
console.log(process.env.NODE_PATH);

分别用cmd和cfexecute执行该脚本，对比输出的模块搜索路径和NODE_PATH值，即可确认变量是否生效。

修复方案 #

方案1：修改ColdFusion服务运行身份（推荐） #

• 打开服务管理器：按下Win+R输入services.msc回车
• 找到ColdFusion对应的服务，右键选择「属性」-「登录」选项卡
• 勾选「此账户」，输入配置了环境变量的Administrator账户名和密码，保存后重启ColdFusion服务即可。

方案2：脚本内强制添加全局模块路径 #

在测试脚本最开头添加如下代码，手动把全局模块路径加入Node的搜索列表：

module.paths.push('C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules');
const puppeteer = require('puppeteer');

方案3：修正本地安装路径 #

如果采用本地安装puppeteer，需要在脚本所在目录（即c:/home/pm/wwwroot/test_files/puppeteer/）下执行npm install puppeteer@9.0.0，确保该目录下存在node_modules/puppeteer文件夹，Node会自动逐级向上搜索同级的node_modules目录。

额外排查点 #

• 对比两台VPS的ColdFusion服务运行身份，可正常运行的设备大概率是采用Administrator账户启动的ColdFusion服务。
• 若修改配置后未生效，可尝试重启服务器确保所有系统变量全局加载。

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