Cpanel环境下Express无法安装的问题求助

排查与修复步骤： #

• 确认安装目录与运行目录一致
  登录Cpanel终端，切换到/home/<user>/public_html/api/（你的package.json所在目录），执行ls -la查看是否存在node_modules及其中的express文件夹。如果没有，在当前目录重新执行npm install，不要在其他目录执行安装命令。

• 清除缓存重新安装
  缓存损坏可能导致依赖安装不完整，执行以下命令：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

  完成后再次检查node_modules/express是否存在。

• 排查puppeteer的影响
  puppeteer在Cpanel环境下安装可能存在编译问题，临时移除该依赖测试：
  编辑package.json，删除"puppeteer": "^15.3.2"，重新执行npm install并启动应用。如果express能正常加载，再单独处理puppeteer的安装配置。

• 检查Cpanel Node.js应用配置
  进入Cpanel的「Setup Node.js App」界面：

  • 确认「Application Root」设置为public_html/api
  • 确认「Application Startup File」设置为app.js（与package.json的main字段一致）
  • 重启Node.js应用使配置生效

• 手动指定模块路径
  如果Node无法识别node_modules，可以在app.js开头添加：

  require('module').Module._initPaths();
  

  或者修改package.json的启动脚本：

  "scripts": {
    "start": "NODE_PATH=./node_modules node app.js"
  }
  

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