宝塔 PM2 管理器显示“启动失败”，但项目实际能访问，或反复提示“已在运行”却无法管理——根本原因往往不是代码问题，而是 package.json 里写的启动命令和 PM2 实际执行环境不匹配，加上 PM2 自身缓存残留导致状态错乱。
PM2 启动失败但日志里没报错？检查 package.json 的 start 脚本是否依赖 shell 特性
宝塔 PM2 管理器底层调用的是非交互式 shell（类似 sh -c），不加载 .bashrc 或 .zshrc，因此所有依赖环境变量、别名、npm 全局 bin 路径的写法都会静默失败。
- 错误写法：
"start": "npm run dev"——npm命令本身可能找不到，因为没走 nvm 激活路径 - 错误写法：
"start": "cross-env NODE_ENV=production node server.js"——cross-env是 npm 全局安装的二进制，PM2 管理器默认不继承该环境 - 正确做法：改用绝对路径 + 显式 Node 调用，例如：
"start": "/www/server/nvm/versions/node/v18.19.1/bin/node server.js" - 更稳妥：删掉
package.json里的start，直接在 PM2 管理器「启动命令」栏填完整路径：/www/server/nvm/versions/node/v18.19.1/bin/node /www/wwwroot/myapp/server.js
PM2 列表显示 errored 或反复 “启动失败”？先清空 PM2 缓存与旧进程
PM2 会缓存启动参数、日志位置、环境快照。切换 Node 版本、重装插件、或多次失败后，这些缓存常导致状态混乱——比如明明进程活着，却显示 offline；或者 reload 不生效。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 执行
pm2 delete all彻底清除所有应用（注意：这不会删代码，只停进程） - 执行
pm2 flush清空所有日志文件（避免旧错误干扰判断） - 执行
pm2 reset重置 PM2 内部状态计数器（解决“已存在同名应用”类假冲突） - 如果用的是宝塔「PM2 管理器」界面启动，操作完后务必刷新页面，不要点“重启”——它可能复用旧缓存配置
宝塔界面显示“启动成功”，但 pm2 list 里是 errored？确认 PM2 是否用了正确的 Node 解释器路径
宝塔 PM2 管理器启动时，若未显式指定 Node 路径，会 fallback 到系统默认 /usr/bin/node 或 /bin/node，而这往往指向一个老旧、无 npm、甚至不兼容 ESM 的版本。
- 查当前 PM2 用的 Node：
pm2 show <app_name> | grep exec_path</app_name>，看输出是不是/www/server/nvm/...开头 - 如果不是，说明 PM2 进程根本没走宝塔装的 Node.js 插件环境，而是用了系统残余的低版本
- 解决方法：卸载系统级 PM2（
npm uninstall -g pm2），再用宝塔插件自带的路径重装：/www/server/nvm/versions/node/v18.19.1/bin/npm install -g pm2 - 验证：
which pm2必须返回/www/server/nvm/versions/node/v18.19.1/bin/pm2，否则后续所有启动都不可靠
最易被忽略的一点：宝塔 PM2 管理器界面上填的「项目路径」必须精确到含 package.json 的目录，且该目录下 node_modules 必须存在、权限属 www 用户。哪怕只差一层 cd ..，require() 就会因模块解析失败而静默退出——而这个错误在 PM2 界面里通常不显示，只在 pm2 logs 里有 Cannot find module。
