宝塔PM2管理器需先安装“Node.js版本管理器”插件并配置正确PATH，启动命令须用绝对路径（如/www/server/nvm/versions/node/v18.19.1/bin/npm start），且package.json中必须存在合法"start"脚本，否则部署失败。
pm2 start npm --name "xxx" -- start 这条命令只在 package.json 里有合法 "start" 脚本时才有效，否则部署会卡住或报 npm ERR! missing script: start。宝塔的 PM2 管理器不是万能启动器，它只是把你的配置翻译成一条固定格式的 PM2 命令去执行。
必须先装对插件，不是“PM2管理器”那个
宝塔默认不带 Node.js 运行环境，“PM2管理器”插件只负责展示进程状态，它本身不提供 node 或 npm 命令。常见错误现象：npm command not found、网站设置里根本看不到“Node.js”类型选项。
- 登录宝塔 → 左侧「软件商店」→ 搜索
Node.js→ 找作者是「宝塔」、状态为「已安装」的那个（名称通常是「Node.js 版本管理器」或「Node.js 项目管理器」） - 没装就选一个 LTS 版本（如
v18.19.1），别选v21.x这类非LTS版，和 Express 生态很多包有兼容问题 - 安装完点「设置」→「环境变量」，确认类似
/www/server/nvm/versions/node/v18.19.1/bin的路径已加入系统PATH - 终端里执行
node -v和npm -v必须能正常输出版本号，否则后续全白搭
Express 项目必须有可执行的 start 脚本
宝塔 PM2 管理器的「一键部署」功能硬编码依赖 package.json 中的 "start" 字段，写成 "dev"、"server" 或直接用 node app.js 启动，它完全识别不了。
-
package.json里至少要有："scripts": { "start": "node ./bin/www" }（Express 默认生成的入口就是./bin/www） - 确保
./bin/www文件首行是#!/usr/bin/env node，且有可执行权限：chmod +x ./bin/www - 不要在
start脚本里加nodemon或--watch—— PM2 不是开发工具，热重载会干扰守护行为 - 要用环境变量（如
NODE_ENV=production），必须写进脚本里："start": "NODE_ENV=production node ./bin/www"，别指望插件界面填的「环境变量」字段能透传
启动命令不能写 npm start，得用绝对路径
宝塔 PM2 管理器执行命令时不会加载你的 shell 环境（比如 ~/.bashrc），所以填 npm start 很大概率失败——它找不到全局 npm，或用了错误的 Node 版本。
- 启动命令必须写成绝对路径，例如：
/www/server/nvm/versions/node/v18.19.1/bin/npm start - 项目路径必须是含
package.json的根目录（如/www/wwwroot/my-express-app），不是./bin/www所在目录；填错会触发Cannot find module - 应用名称（
Name字段）必须填，建议小写字母+短横线，如user-api；不填会导致 PM2 无法识别进程，重启、日志都失效 - 如果用了
ecosystem.config.js，启动命令就得是：/www/server/nvm/versions/node/v18.19.1/bin/pm2 start ecosystem.config.js
Nginx 反向代理配错，502 就必然发生
curl http://127.0.0.1:3000 能通，但浏览器访问域名就 502，说明请求压根没到 Express 进程——Nginx 拦在中间，却不知道往哪转。
- 进「网站」→ 点开对应站点 → 「反向代理」→ 添加，目标 URL 填
http://127.0.0.1:3000（端口必须和 Express 实际监听的一致） - 务必关掉「启用缓存」，Express 是动态服务，开了缓存会返回旧响应
- Express 的
app.listen()必须绑定0.0.0.0:3000，不能只写127.0.0.1:3000或留空（某些框架默认只绑本地） - 反向代理配置里加两行：
proxy_set_header Host $host;和proxy_set_header X-Real-IP $remote_addr;，否则 Express 拿不到真实 IP 和 Host
实际部署中最容易被忽略的点是：Express 监听地址、Nginx 代理目标端口、PM2 启动命令所用的 Node 路径，这三者必须严格对齐，差一个字符，502 或进程秒退就跟着来了。
