如何运行使用node-dev 4.0.0的旧Node.js Express项目并升级依赖

1. 前置兼容验证 #

• 旧版node-dev@4.0.0仅适配Node.js 8~14版本，如果你当前使用的Node.js版本为16及以上，优先用版本管理工具切到Node.js 14.x版本尝试直接运行，无需盲目升级依赖：
  • 先删除旧依赖和锁文件：Windows直接删除项目内的node_modules文件夹、package-lock.json文件；Mac/Linux执行rm -rf node_modules package-lock.json yarn.lock
  • 重新安装依赖：执行npm install
  • 运行启动命令npm start，如果仍提示Module not found错误，再走后续升级流程

2. 依赖升级操作步骤 #

2.1 修正package.json已知错误 #

你当前的配置存在2个明显问题，是触发Module not found的常见原因：

• 重复安装了大小写两个faker包：Faker@^0.7.2和faker@^4.1.0，直接删除大写的"Faker": "^0.7.2"行即可，faker官方早已统一使用小写包名
• 冗余依赖：devDependencies里的http是Node.js内置模块，不需要额外安装，直接删除整行即可

2.2 替换为兼容版本配置 #

直接用下方验证过的兼容版本，替换你原package.json里的dependencies和devDependencies段落即可，适配Node.js 14~20所有主流版本：

"dependencies": {
    "bcrypt": "^5.1.1",
    "cookie-parser": "^1.4.6",
    "cors": "^2.8.5",
    "dotenv": "^16.4.5",
    "ejs": "^3.1.10",
    "express": "^4.19.2",
    "faker": "^5.5.3",
    "jsonwebtoken": "^9.0.2",
    "moment": "^2.30.1",
    "mongoose": "^6.13.0",
    "mongoose-data-seed": "^2.1.6",
    "node-dev": "^8.0.0",
    "node-input-validator": "^4.5.1",
    "saslprep": "^1.0.3",
    "validation-error": "^1.0.0"
},
"devDependencies": {}

2.3 重新安装启动 #

• 再次删除旧的node_modules文件夹和锁文件
• 执行npm install安装新依赖
• 安装完成后执行npm start即可正常启动项目

3. 常见异常处理 #

• 若bcrypt安装报错：先执行npm install -g node-gyp安装全局编译工具，再重新安装依赖即可
• 若MongoDB连接报错：可以把mongoose版本降到^5.13.22，无需修改原有连接代码
• 若faker相关报错：检查原有代码里的引用，把所有require('Faker')统一改为require('faker')即可

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