升级webpack依赖后启动项目报错：需在@ngtools/webpack配置中指定tsConfigPath

这个问题我之前升级ngc-webpack到4.x版本时也碰到过，核心原因是ngc-webpack@4.x对@ngtools/webpack的配置逻辑做了变更——哪怕你已经配置了tsConfigPath，也可能因为配置位置不对或版本兼容问题触发报错。下面是几个针对性的解决方向：

1. 调整ngc-webpack插件的配置结构 #

ngc-webpack@3.x版本允许你通过ngtoolsWebpackConfig嵌套传递tsConfigPath给@ngtools/webpack，但4.x版本简化了配置逻辑，需要直接在NgcWebpackPlugin的根配置项里指定tsConfigPath，不再需要嵌套层级：

// ❌ 旧的3.x版本配置（会导致4.x报错）
new NgcWebpackPlugin({
  ngtoolsWebpackConfig: {
    tsConfigPath: './tsconfig.json'
  }
})

// ✅ 新的4.x版本配置（推荐用绝对路径避免路径歧义）
const path = require('path');
new NgcWebpackPlugin({
  tsConfigPath: path.resolve(__dirname, './tsconfig.json')
})

2. 确认@ngtools/webpack的版本兼容性 #

ngc-webpack@4.x对@ngtools/webpack的版本有严格要求，你可以查看ngc-webpack@4.1.1的peer依赖说明，通常它要求@ngtools/webpack处于^1.10.0到^2.0.0之间（具体以官方版本的依赖声明为准）。如果你的@ngtools/webpack版本过高或过低，都会出现配置不兼容的问题。

建议先卸载当前版本，安装匹配的版本：

npm uninstall @ngtools/webpack --save-dev
npm install @ngtools/webpack@1.10.2 --save-dev # 示例版本，可根据ngc-webpack的peer依赖调整

3. 验证tsconfig.json的路径准确性 #

确保你配置的tsConfigPath是相对于webpack配置文件（webpack.dev.js）的路径，而不是项目根目录。比如如果webpack.dev.js放在config/文件夹下，路径应该写../tsconfig.json，用绝对路径（如上面示例中的path.resolve写法）可以彻底避免路径歧义。

4. 清理缓存并重新构建 #

旧的依赖缓存或构建缓存可能干扰新版本的配置加载，建议执行以下步骤重置环境：

# 删除依赖包和锁文件
rm -rf node_modules package-lock.json
# 重新安装依赖
npm install
# 清理旧的构建产物
rm -rf dist
# 重启项目
npm start

按照以上步骤排查，基本可以解决这个报错问题。

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