Webpack 5配置devtool:'source-map'触发API schema校验错误问题咨询
Webpack 5 构建脚本运行异常问题定位
异常现象
运行教学配套的监听构建命令sh -c webpack --watch -d --output ./target/classes/static/built/bundle.js(对应教程标注的npm run-script watch脚本)时,webpack直接抛出配置校验失败错误,具体报错内容:
[webpack-cli] Invalid configuration object. Webpack has been initialized using a configuration object that does not match the API schema.
- configuration.devtool should match pattern "^(inline-|hidden-|eval-)?(nosources-)?(cheap-(module-)?)?source-map$".
BREAKING CHANGE since webpack 5: The devtool option is more strict.
Please strictly follow the order of the keywords in the pattern.
当前使用的Webpack版本为5.29.0,项目对应的webpack.config.js全量配置:
let path = require('path'); module.exports = { entry: './src/main/js/App.js', devtool: 'source-map', cache: true, mode: 'development', output: { path: __dirname, filename: './src/main/resources/static/built/bundle.js' }, module: { rules: [ { test: path.join(__dirname, '.'), exclude: /(node_modules)/, use: [{ loader: 'babel-loader', options: { presets: ["@babel/preset-env", "@babel/preset-react"] } }] }, { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] }, { test: /\.(png|svg|jpg|gif|eot|otf|ttf|woff|woff2)$/, use: [ { loader: 'url-loader', options: {} } ] } ] } };
问题根源
报错指向devtool配置不符合正则规则,核心原因和Webpack 5的破坏性更新直接相关:
- 命令行中携带的
-d参数是Webpack 4及更早版本的快捷参数,原本是三个参数的组合:--debug、--devtool cheap-module-eval-source-map、--output-pathinfo; - Webpack 5直接移除了这个快捷参数的兼容逻辑,同时对devtool的取值做了严格的schema校验,不再兼容旧版参数自动推导的非标准取值,命令行参数会和配置文件中的
devtool: 'source-map'做合并,最终生成的devtool值不满足官方要求的正则匹配规则,直接触发校验拦截。 - 配置文件中本身写的
devtool: 'source-map'是完全符合规则的,不需要修改。
修正操作
- 第一优先级修改:调整package.json中watch脚本的命令内容,移除Webpack 5不再兼容的
-d参数,修正后的命令参考:sh -c webpack --watch --output ./target/classes/static/built/bundle.js - 如果需要保留开发环境的源码映射能力,可在命令行显式传入符合规则的devtool值,用
--devtool source-map替代旧的-d参数。 - 额外注意:当前配置文件中写死的输出路径
./src/main/resources/static/built/bundle.js和命令行指定的输出路径./target/classes/static/built/bundle.js存在不一致,解决devtool报错后需要统一两处路径,保证构建产物能被Spring Boot正常加载为静态资源。
内容的提问来源于stack exchange,提问作者Jayanga Kaushalya
相关产品推荐
相关产品推荐

