如何解决Node.js中出现的‘configFactory is not a function’错误？

1. 排查webpack相关依赖版本冲突 #

这个错误大概率是webpack、webpack-cli、webpack-dev-server三者版本不兼容导致的：

• 打开项目的package.json，核对这三个依赖的版本号，确保webpack 5.x搭配webpack-cli 4.x+、webpack-dev-server 4.x+；webpack 4.x则对应webpack-cli 3.x、webpack-dev-server 3.x。
• 若版本不匹配，卸载后重新安装兼容版本：

  npm uninstall webpack webpack-cli webpack-dev-server
  npm install webpack@^5.88.0 webpack-cli@^5.1.4 webpack-dev-server@^4.15.1 --save-dev
  

2. Vue项目专属排查（若适用） #

如果是Vue项目，错误常出现在@vue/cli-service与webpack依赖冲突：

• 更新@vue/cli-service到兼容版本：

  npm update @vue/cli-service
  

• 彻底清理依赖后重装：

  rm -rf node_modules package-lock.json
  npm install
  

3. 检查自定义webpack配置文件 #

若项目有自定义webpack.config.js，确认配置导出方式正确：

• 必须导出配置对象，而非函数（除非工具链明确支持函数式导出），示例：

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js'
    }
    // 其他配置项
  }
  

4. 验证npm start脚本命令 #

查看package.json的scripts字段，确认start命令无误：

• Vue项目应为"start": "vue-cli-service serve"，普通webpack项目应为"start": "webpack serve"，避免拼写错误或过时参数。

5. 降级Node.js版本（极端场景） #

若更新Node后出现问题，可能是新版本与项目依赖不兼容，用nvm切换到LTS版本：

nvm install 20.10.0
nvm use 20.10.0

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