unity io_error ai_generated true

UnityEngine.AddressableAssets: Initialization failed: Failed to load content catalog from path

ID: unity/addressable-catalog-load-failed

Also available as: JSON · Markdown · 中文
92%Fix Rate
87%Confidence
1Evidence
2024-04-22First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
Unity 2022.3 active — — —
Unity 2023.1 active — — —
Addressables 1.21.0 active — — —
Addressables 1.22.0 active — — —

Root Cause

The Addressables content catalog file (catalog.json) is missing, corrupt, or not deployed to the correct platform path.

generic

中文

Addressables 内容目录文件 (catalog.json) 缺失、损坏或未部署到正确的平台路径。

Official Documentation

https://docs.unity3d.com/Packages/[email protected]/manual/LoadContentCatalog.html

Workarounds

  1. 95% success Rebuild the Addressables content: open Addressables Groups window, click Build > Clean Build > All. 
    Rebuild the Addressables content: open Addressables Groups window, click Build > Clean Build > All.
  2. 90% success Verify that the catalog is included in the build by checking 'Build Remote Catalog' in Addressables settings and ensuring the path is correct. 
    Verify that the catalog is included in the build by checking 'Build Remote Catalog' in Addressables settings and ensuring the path is correct.

中文步骤

  1. Rebuild the Addressables content: open Addressables Groups window, click Build > Clean Build > All.
  2. Verify that the catalog is included in the build by checking 'Build Remote Catalog' in Addressables settings and ensuring the path is correct.

Dead Ends

Common approaches that don't work:

  1. 75% fail

    The catalog is generated during a build, not during import; a fresh Addressables build is required.

  2. 90% fail

    Addressables uses hash files to verify integrity; manual copy bypasses hash generation.