升级AngularJS至v1.8.2后出现$injector:modulerr错误如何排查

$injector/modulerr本质是AngularJS模块初始化阶段抛出未捕获异常导致的加载失败，结合jQuery、AngularJS跨大版本升级的场景，可按照以下步骤排查：

• 第一步：输出完整错误栈定位触发点
  默认AngularJS会截断错误信息，可在引入AngularJS文件后、业务代码执行前添加全局错误捕获逻辑，拿到完整报错栈和触发文件位置：

window.addEventListener('error', function(e) {
  console.error('完整错误信息：', e.error);
  console.error('触发文件：', e.filename, '行号：', e.lineno, '列号：', e.colno);
});

同时开启AngularJS调试模式，避免框架隐藏错误细节：

angular.module('你的主模块名称').config(['$compileProvider', function($compileProvider) {
  // 开启调试信息输出
  $compileProvider.debugInfoEnabled(true);
}]);

• 第二步：核对所有AngularJS相关依赖的版本一致性
  所有AngularJS生态子模块（ngRoute、ngAnimate、ngResource等）的版本必须和主框架v1.8.2完全一致，即使小版本号不一致也可能出现兼容问题，不要仅确认是「最新版本」，需逐个核对版本号完全匹配。
• 第三步：检查资源加载顺序
  必须保证加载顺序为：jQuery v3.6.0 → AngularJS v1.8.2 → 其他Angular子模块 → 业务代码。如果先加载AngularJS再加载jQuery，Angular会默认使用内置的jqLite，和外部引入的jQuery产生冲突，导致依赖jQuery的指令、服务初始化失败。
• 第四步：逐个排查模块依赖项
  注释主模块声明的非核心依赖项，每注释一个就刷新页面验证，如果注释到某个依赖后报错消失，即可定位是该模块内部存在初始化错误。同时检查依赖名称拼写是否正确、对应依赖文件是否成功加载，不存在404情况。
• 第五步：排查废弃API兼容问题
  1. AngularJS从1.4.x升级到1.8.x移除了大量废弃API，比如$http的success/error方法、部分全局工具函数，如果自定义模块或第三方依赖中使用了已移除的API，会触发初始化报错。
  2. jQuery v3.x也移除了.live()、.die()、事件绑定版.toggle()等老版本API，如果Angular指令、组件中调用了这些已移除方法，也会导致模块加载失败。
• 第六步：检查压缩混淆后的依赖注入注解
  如果项目经过压缩混淆，必须保证所有依赖注入都使用数组式声明或*$inject显式注解*，避免压缩后变量名被改写导致Angular找不到对应依赖，错误示例和正确示例如下：

// 错误写法：隐式注入，压缩后变量名被改会报错
app.controller('MyCtrl', function($scope, $route) {});

// 正确写法1：数组式声明
app.controller('MyCtrl', ['$scope', '$route', function($scope, $route) {
  // 业务逻辑
}]);

// 正确写法2：$inject显式注解
function MyCtrl($scope, $route) {}
MyCtrl.$inject = ['$scope', '$route'];
app.controller('MyCtrl', MyCtrl);

内容的提问来源于stack exchange，提问作者Juan Ignacio Guimarey