Craft CMS插件AssetBundle引发后台Craft.js未定义错误问题咨询

问题本质 #

Craft CMS核心的CpAsset资源包本身已经内置了Craft核心JS的注册逻辑，会根据站点devMode配置自动切换加载未压缩的Craft.js（devMode开启时）或者压缩的Craft.min.js（devMode关闭时），两个文件同时加载说明存在重复注册Craft核心JS资源的逻辑，和CpAsset内置的注册规则冲突。

常见排查与修复方案 #

• 检查自定义AssetBundle的配置，确认你没有手动把Craft.js或者Craft.min.js写入$js资源列表。CpAsset已经内置核心JS的注册逻辑，额外手动添加会直接导致重复加载。
• 检查Twig模板内的资源引入代码，确认你没有通过{% js %}标签、registerJsFile()方法手动引入Craft核心JS，所有后台页面只要依赖了CpAsset，核心JS会自动加载无需额外引入。
• 检查自定义资源包的依赖配置，确认是否同时依赖了两个不同的核心资源包，或者依赖的第三方资源包硬编码引入了另一版本的Craft JS，这种情况需要调整依赖树，移除重复引入的资源包。
• 调整资源包注册时机，如果你在控制器/模块的init()方法里提前注册了自定义资源包，早于CpAsset的注册逻辑，可能导致Yii资源管理器无法正确去重。可以将注册逻辑放到控制器的afterAction阶段或者Twig模板内执行，或者在自定义资源包的$depends属性里明确声明依赖CpAsset::class，让Yii自动处理加载顺序和资源去重。
• 检查站点资源合并配置，如果你开启了后台资源合并压缩，可临时关闭config/general.php里的enableAssetBundling配置测试，资源合并逻辑异常时也可能导致重复加载。

快速调试方法 #

你可以在控制器对应方法内加入以下代码，快速排查资源注册情况：

// 临时调试代码，用完删除
$cpBundle = \craft\web\assets\cp\CpAsset::register($this->view);
var_dump(array_keys($this->view->jsFiles));
exit;

如果返回的JS资源路径列表里同时出现Craft.js和Craft.min.js，即可定位是注册逻辑重复问题，向上溯源找到额外注册的代码删除即可。

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