Cocos Creator 3.8.6预加载bundle-a报错：需先加载bundle-b

一、可清理的缓存项 #

• 编辑器缓存：关闭Cocos Creator，删除项目根目录下的library文件夹，重启编辑器后会自动重新生成。
• 构建产物缓存：若为构建后出现的问题，删除build目录下对应平台的构建文件夹，重新构建。
• Web平台浏览器缓存：在浏览器开发者工具中勾选「禁用缓存」，或手动清除当前站点的缓存数据。

二、调试Bundle依赖关系的方法 #

• 检查Bundle配置文件：打开项目assets目录下各Bundle对应的config.json，查看dependencies字段，确认bundle-a的配置中是否意外添加了bundle-b的依赖。
• 用内置依赖分析工具：编辑器顶部菜单栏选「项目」→「项目设置」→「功能模块」，启用「依赖分析」；在资源管理器右键点击bundle-a根目录，选「查看依赖关系」，排查是否存在间接依赖bundle-b的资源（如脚本、资源引用了bundle-b内容）。
• 打印加载日志：预加载bundle-a前，添加cc.assetManager.downloader.maxConcurrency = 1;强制串行加载；同时通过cc.assetManager.on('bundleLoad', (bundleName) => { console.log('Loaded bundle:', bundleName); });监听加载事件，确认实际加载顺序是否符合预期。
• 全局搜索脚本引用：在项目中全局搜索bundle-a的脚本是否存在require('bundle-b/xxx')或动态加载bundle-b资源的代码，包括继承、混合等隐式引用场景。

三、其他解决思路 #

• 核对优先级配置：在「项目设置」→「资源管理」→「Bundle配置」中重新确认bundle-a优先级为1、bundle-b为2，避免配置未保存生效。
• 重置Bundle配置：删除现有Bundle配置，重新创建bundle-a和bundle-b，重新设置依赖与优先级后测试预加载流程。
• 排查资源UUID冲突：使用「项目」→「工具」→「资源UUID检查工具」，排查跨Bundle资源引用导致的UUID重复或错误问题。
• 版本验证：临时切换到Cocos Creator 3.8.5或3.8.7版本，确认是否为当前版本的bug导致依赖判断异常。

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