在cPanel中部署Node.js应用失败问题求助

关键排查步骤 #

• 修复package.json脚本配置
  cPanel对package.json的scripts字段校验严格，首先确认start命令指向正确的Express入口文件，比如：

  "scripts": {
    "start": "node server.js",
    "build": "ng build --prod"
  }
  

  彻底清除所有无效脚本项（比如之前报错的test命令残留），避免触发cPanel的校验逻辑。

• 梳理依赖安装逻辑

  • 若在cPanel上构建前端，确保devDependencies中的@angular/cli等构建工具没有被误删；更稳妥的方式是本地执行ng build --prod，把dist目录的打包产物直接上传到cPanel，由Express托管静态文件，避免服务器端构建。
  • 不要随意删除依赖，除非能明确确认该依赖无任何作用。比如g、global这类可能是误加的，但要先检查是否有脚本依赖这些包。

• 核对cPanel Node.js部署配置

  • 在cPanel的Setup Node.js App界面，确认应用根目录指向后端入口文件所在的文件夹；如果前后端分离部署，要确保前端dist目录被配置为静态资源路径。
  • 查看服务器日志：在Node.js管理界面点击Logs，获取具体报错信息（比截图的泛化提示更有用），常见问题包括端口冲突、文件权限不足、Node版本不兼容。

• 检查文件权限与路径

  • cPanel上的应用文件夹权限设为755，文件权限设为644，避免Node进程无法读取文件。
  • 确认package.json中所有路径（比如脚本里的文件路径）与服务器实际结构一致，服务器路径区分大小写，本地相对路径要适配服务器环境。

快速验证方案 #

1. 本地模拟生产环境：执行npm run build构建前端，再npm start启动后端，确认本地正常运行后再上传到cPanel。
2. 简化package.json，只保留必要的脚本和依赖，逐步添加其他项定位问题。

内容的提问来源于stack exchange，提问作者Hélder De Pégaso