运行webpack-dev-server报错：configuration.entry[0]不符合API schema

问题根源分析 #

错误提示configuration.entry[0] should be a non-empty string是两个问题叠加导致的：

1. webpack.config.js的entry格式错误：当前entry用了{ path: 'xxx' }的写法，不符合webpack的entry规范——要么直接传入入口文件路径字符串，要么传入以chunk名称为键、路径为值的对象（用path作为chunk名易和webpack内部属性混淆）。
2. package.json的dev命令重复传参：命令行里的--entry和--output-filename参数会和配置文件里的entry/output合并，导致webpack解析出无效的entry数组，触发schema校验错误。另外--output-filename前多了个点，会导致输出路径错误。

修复步骤 #

1. 修正webpack.config.js的entry配置 #

将entry改为正确格式，二选一即可：

• 单入口字符串形式（简单场景）：

const path = require('path');
const config = (env) => {
  console.log('env:', env);
  return {
    mode: env['--mode'] || 'development',
    // 修正entry为字符串路径
    entry: path.join(__dirname, './client/src/index.js'),
    output: {
      path: path.join(__dirname, './client/dist'),
      filename: 'bundle.js'
    },
    module: {
      rules: [
        {
          // 修正正则，匹配.js结尾的文件
          test: /\.js$/,
          // 修正node_modules拼写
          exclude: /node_modules/,
          loader: 'babel-loader'
        },
        {
          // 修正正则，匹配css/scss结尾的文件
          test: /\.(css|scss)$/,
          use: ['style-loader', 'css-loader', 'sass-loader']
        },
      ]
    }
  }
}

module.exports = config;

• 命名入口对象形式（推荐，方便后续多入口扩展）：

entry: {
  main: path.join(__dirname, './client/src/index.js')
},

2. 简化package.json的dev命令 #

移除命令行中多余的--entry和--output-filename参数，配置文件已定义这些内容：

{
  "scripts": {
    // 修正后的dev命令
    "dev": "webpack-dev-server --env --mode=development",
    // 其他脚本保持不变
    "test": "jest --watch",
    "server": "nodemon server/server.js",
    "start": "webpack --watch --env --mode=development",
    "build": "webpack --env --mode=production",
    // ...其余脚本
  }
}

3. 额外优化（可选） #

如果需要保留package.json里的config变量，可在webpack.config.js中直接读取，而非命令行传参：

// 在webpack.config.js顶部添加
const pkg = require('./package.json');

// 替换entry配置
entry: pkg.config.input_path,

但更推荐用相对路径（如path.join(__dirname, './client/src/index.js')），避免绝对路径在不同环境下的兼容性问题。

验证修复 #

执行npm run dev，webpack-dev-server应能正常启动，不再出现entry配置错误。

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