Unity小体积Android构建中Addressables功能异常排查求助

针对你遇到的「部分Android构建体积比常规小1MB且Addressables失效」的问题，核心方向是异常构建遗漏了Addressables核心元数据或本地资源包，以下是针对性排查步骤：

1. 对比Addressables构建报告 #

• 生成构建报告：打开Addressables Groups窗口 → 点击Build → Build Player Content，报告文件位于Library/com.unity.addressables/AssetBundles/Android/buildreport.json
• 对比正常与异常构建的报告，重点核查：
  • 是否缺失AssetBundle条目
  • catalog.json的大小差异（该文件是Addressables核心元数据，不完整会直接导致加载失败）
  • 标记为local的资源是否被排除在Player构建外

2. 用Build Report Tool核查Player打包内容 #

• 打开Window → Analysis → Build Report，对比正常与异常构建的资源列表：
  • 确认addressables_content_state.bin是否存在（该文件是Addressables运行时状态文件，缺失会导致无法识别本地资源）
  • 检查本地AssetBundle是否被打包进APK的assets/bin/Data/StreamingAssets目录，异常构建大概率遗漏了部分bundle

3. 排查Android构建的压缩与剥离配置 #

• 打开Player Settings → Android → Publishing Settings：
  • 检查Custom Main Gradle Template是否被修改，是否有规则意外移除了StreamingAssets目录的打包
  • 验证**Build App Bundle (Google Play)**选项：若异常构建用了App Bundle、正常用了APK，可能因Split APK导致资源分散在未加载的分包中
  • 检查Strip Engine Code和Managed Stripping Level：过高的剥离等级会误删Addressables的反射依赖代码，导致元数据解析失败

4. 校验Addressables Group打包规则 #

• 检查所有Local Group的Build Path是否设为LocalBuildPath、Load Path是否为LocalLoadPath
• 确认Group的Include In Build选项未被意外取消（尤其是动态生成的Group）
• 排查是否有标记为Addressable但未分配到任何Group的资源，这类资源可能在异常构建中被忽略

5. 分析运行时日志定位具体错误 #

• 用adb logcat或Android Studio捕获异常构建的运行时日志，搜索关键词：
  • Addressables、Catalog、AssetBundle
  • 重点关注Failed to load catalog、Bundle not found、Key not found in catalog这类错误，定位缺失的资源或元数据

6. 排查自动化构建脚本（如有） #

• 若使用CI/CD或自定义构建脚本，检查是否在异常构建时传入了错误参数：
  • 比如调用Addressables.BuildPlayerContent时，BuildPlayerContentArgs是否错误排除了部分资源
  • 确认构建前是否有脚本修改了Addressables的Group配置

7. 清理Unity全局缓存后重新构建 #

• 除了Addressables缓存，还需删除以下目录：
  • Library、Temp、Obj
  • ProjectSettings/AddressableAssetsData/ContentState.bin
• 重新构建Addressables资源包和Player

内容的提问来源于stack exchange，提问作者Batuhan Karavelioğulları