MERN应用保存文件报UnhandledPromiseRejection且修改不生效如何解决

你遇到的修改不生效+未捕获Promise拒绝报错的组合问题，基本和项目热重载模块异常、异步逻辑未做错误捕获、依赖冲突三类原因有关，按以下顺序排查即可：

• 第一步：定位具体报错根源
  在项目服务端入口文件（通常是根目录下的server.js）和前端入口文件（client/src/index.js）顶部都添加以下代码，开启完整的错误堆栈打印：

process.on('unhandledRejection', (error) => {
  console.error('未捕获Promise错误完整堆栈：', error.stack)
})

重启项目后修改文件保存，根据控制台打印的堆栈信息就能直接定位到出错的具体模块/代码行。

• 第二步：处理依赖冲突与缓存问题
  该MERN模板的热重载依赖版本如果和本地环境不匹配会直接触发该类错误，按以下操作重置依赖：

1. 删除根目录下的node_modules文件夹、package-lock.json/yarn.lock文件
2. 删除client目录下的node_modules文件夹、.cache文件夹、build文件夹
3. 在根目录执行npm install重新安装所有依赖，完成后再启动项目测试

• 第三步：排查文件监听与端口问题

1. 部分系统下Node进程没有项目目录的读写权限，会导致文件监听失败触发热重载报错，Linux/macOS下执行sudo chmod -R 755 你的项目根目录路径授权，Windows下用管理员身份打开终端再启动项目
2. 检查模板默认使用的3000（前端）、5000（后端）端口是否被其他进程占用：
   macOS/Linux执行lsof -i:3000、Windows执行netstat -ano | findstr "3000"，如果有占用直接结束对应进程，或者修改package.json中的启动端口配置

• 第四步：排查代码逻辑问题
  如果你新增的代码中包含async/await逻辑但没有用try/catch包裹，或者调用了返回Promise的方法没有添加.catch()错误处理，代码执行时会抛出未捕获Promise错误，同时阻断热重载导致修改不生效。可以先注释掉你新增的所有代码，保存文件测试是否还报错，若不再报错逐行排查新增的异步逻辑即可。

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