unity
io_error
ai_generated
true
UnityEngine.AddressableAssets: 初始化失败: 无法从路径加载内容目录
UnityEngine.AddressableAssets: Initialization failed: Failed to load content catalog from path
ID: unity/addressable-catalog-load-failed
92%修复率
87%置信度
1证据数
2024-04-22首次发现
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| Unity 2022.3 | active | — | — | — |
| Unity 2023.1 | active | — | — | — |
| Addressables 1.21.0 | active | — | — | — |
| Addressables 1.22.0 | active | — | — | — |
根因分析
Addressables 内容目录文件 (catalog.json) 缺失、损坏或未部署到正确的平台路径。
English
The Addressables content catalog file (catalog.json) is missing, corrupt, or not deployed to the correct platform path.
官方文档
https://docs.unity3d.com/Packages/[email protected]/manual/LoadContentCatalog.html解决方案
-
Rebuild the Addressables content: open Addressables Groups window, click Build > Clean Build > All.
-
Verify that the catalog is included in the build by checking 'Build Remote Catalog' in Addressables settings and ensuring the path is correct.
无效尝试
常见但无效的做法:
-
75% 失败
The catalog is generated during a build, not during import; a fresh Addressables build is required.
-
90% 失败
Addressables uses hash files to verify integrity; manual copy bypasses hash generation.