unity
io_error
ai_generated
true
UnityEngine.AddressableAssets: Initialization failed: Failed to load content catalog from path 'Library/com.unity.addressables/aa/catalog.json'. Exception: System.IO.FileNotFoundException
ID: unity/addressable-catalog-load-failure
93%Fix Rate
87%Confidence
1Evidence
2023-09-12First Seen
Version Compatibility
| Version | Status | Introduced | Deprecated | Notes |
|---|---|---|---|---|
| Unity 2022.3 | active | — | — | — |
| Addressables 1.21.0 | active | — | — | — |
| Unity 2023.1 | active | — | — | — |
Root Cause
The Addressables content catalog file is missing or not built, often because the Addressables build was not run or the catalog was deleted.
generic中文
Addressables内容目录文件丢失或未构建,通常是因为Addressables构建未运行或目录被删除。
Official Documentation
https://docs.unity3d.com/Packages/[email protected]/manual/InitializeAsync.htmlWorkarounds
-
95% success Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.
Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.
-
90% success If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.
If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.
中文步骤
通过Window > Asset Management > Addressables > Groups重建Addressables内容,然后点击'Build' > 'New Build' > 'Default Build Script'。
如果在构建的播放器中缺少目录,请确保在Addressables设置中启用'Build Remote Catalog',并通过'Player Preload'将目录包含在构建中。
Dead Ends
Common approaches that don't work:
-
90% fail
Manually creating a catalog.json file with dummy content causes deserialization errors because the format is specific to Addressables.
-
85% fail
Copying a catalog.json from another project does not work because it contains references to assets specific to that project's groups.