Cordova 9.0下Ionic4应用插件模块重复定义报错问题咨询

你遇到的重复模块定义报错，和排查到的三个Injecter.java文件直接相关，和之前遇到的通用场景有本质区别：

• 正常Cordova运行逻辑中，cordova_plugins.js是WebView内核在初始化阶段自动加载的核心文件，文件里会批量完成所有插件的模块定义注册。
• 项目里的三个Injecter实现，都主动执行了assetManager.open("www/cordova_plugins.js")的读取逻辑，会把这个已经被内核加载过的文件内容再次取出来注入执行。同一套模块定义被反复执行2-3次，每次碰到已经注册过的模块ID，就会抛出你看到的module xxx already defined未捕获异常。
• 之前查阅到的通用解决方案对你无效，是因为那些方案解决的是「同一份插件被重复安装，导致cordova_plugins.js本身内容重复」的场景，而你的问题是「同一份cordova_plugins.js被多个代码路径反复执行」，问题根源不一样。

• 第一步：定位实际生效的Injecter实例。在每个读取cordova_plugins.js的代码行前加调试日志，打印当前的类路径和调用栈，确认冷启动阶段到底有几个Injecter真的执行了这段读文件的逻辑。从给出的路径能看出来，项目里存在三份重复的injectview插件实现：两份分别放在Wrapper插件目录、app主源码目录，还有一份放在Ionic项目的internal_plugins下，本质是插件安装过程中产生了残留副本。
• 第二步：清理重复的插件实现。按照Cordova的插件加载规则，同一个插件只需要保留一份有效实现：
  • 优先删除app主源码目录下错位存放的de.fastr.phonegap.plugins.Injecter.java，这个文件不属于插件的标准存放路径，基本是之前手动复制插件代码时留下的残留，不会参与正常的插件编译流程校验，很容易被单独实例化。
  • 对比剩下两个Injecter的代码逻辑，如果功能完全一致，优先保留和Ionic项目源码绑定的internal_plugins/injectview-cordova-plugin下的实现，删掉Cordova Wrapper全局插件目录下的重复副本——内部插件的实现是和当前项目强绑定的，全局Wrapper目录下的复用代码很容易因为版本不同步，出现重复实例化的问题。
• 第三步：修正Injecter的读取逻辑。就算只保留一份Injecter，也不需要让它主动读取cordova_plugins.js：这个文件本身是Cordova内核自动加载的核心文件，Injecter的设计初衷是注入自定义业务代码、非官方插件的JS逻辑，完全没必要去读已经被内核加载过的文件，直接把这段读cordova_plugins.js的代码注释掉，不会影响Injecter的正常功能。

• 这类初始化阶段的未捕获异常，不会直接导致应用功能崩溃（第一次加载的模块定义是完全有效的，后续重复执行的代码碰到已存在的模块会直接抛错跳过），但会带来明确的性能损耗：
  • 每次重复执行cordova_plugins.js的内容，都会解析一遍上千行的JS注册逻辑，冷启动阶段会增加200-500ms的额外耗时，在配置较低的安卓设备上，这个耗时还会进一步升高。
  • 控制台持续抛出未捕获异常，会触发WebView的异常捕获机制，在部分定制化的安卓系统上，会触发JS引擎的执行节流策略，导致后续业务逻辑的JS运行效率下降。

注意：不要图省事直接删掉 Cordova自带define方法里的重复定义判断，这样做会让后续重复注入的插件代码覆盖原有模块定义，出现插件功能随机失效的诡异问题，排查成本会高很多。

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