Angular生产环境JIT编译报错，配置Terser插件及ngDevMode问题

修复Terser-Webpack-Plugin的「terserOptions未知属性」错误 #

你犯了一个常见配置错误：terserOptions不能直接放在Webpack配置的根层级，必须嵌套在optimization.minimizer数组内的TerserPlugin实例中。

正确的extra.webpack.config.js配置 #

const TerserPlugin = require('terser-webpack-plugin');

module.exports = {
  optimization: {
    minimizer: [
      new TerserPlugin({
        terserOptions: {
          // 根据需求添加配置，例如保留类名/函数名用于调试
          keep_classnames: true,
          keep_fnames: true,
          compress: {
            drop_debugger: false,
            drop_console: false
          }
        }
      })
    ]
  }
};

提示：Angular CLI默认已集成TerserPlugin，若使用@angular-builders/custom-webpack扩展配置，无需手动安装也能使用；若已手动安装，需确保TerserPlugin版本与项目依赖的Webpack版本兼容（可查看package-lock.json确认Webpack版本后匹配对应Terser版本）。

开启ngDevMode定位JIT编译问题 #

要在生产环境强制启用ngDevMode，推荐两种方式：

方式1：Webpack DefinePlugin全局注入 #

在额外Webpack配置中添加DefinePlugin，确保编译时ngDevMode被替换为true：

const webpack = require('webpack');
const TerserPlugin = require('terser-webpack-plugin');

module.exports = {
  plugins: [
    new webpack.DefinePlugin({
      ngDevMode: JSON.stringify(true)
    })
  ],
  optimization: {
    minimizer: [
      new TerserPlugin({
        terserOptions: {
          keep_classnames: true,
          keep_fnames: true,
          // 避免Terser删除ngDevMode相关代码
          compress: {
            pure_funcs: [] // 清空可能包含ngDevMode的pure_funcs配置
          }
        }
      })
    ]
  }
};

方式2：修改tsconfig.json #

在tsconfig.json中添加Angular编译选项：

{
  "compilerOptions": {
    // 现有编译配置
  },
  "angularCompilerOptions": {
    "ngDevMode": true,
    "enableIvy": true // 若项目使用Ivy，需确保此选项开启
  }
}

注意：若同时使用两种方式，Webpack DefinePlugin的优先级更高，因为它会直接在代码中替换变量值。

后续排查步骤 #

1. 重新构建生产环境：开启ngDevMode后，控制台会输出详细错误，明确指出哪个组件/模块未通过AOT编译（通常是第三方库使用了JIT特性，比如动态生成模板）。
2. 检查依赖兼容性：确认第三方库版本与Angular版本匹配，部分旧库在Ivy模式下存在AOT编译问题。
3. 验证Webpack配置合并：若使用@angular-builders/custom-webpack，需确保angular.json中customWebpackConfig.path指向你的extra.webpack.config.js，且builder设置为@angular-builders/custom-webpack:browser。

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