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

其他格式: JSON · Markdown 中文 · English
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.

generic

官方文档

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

解决方案

  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.

无效尝试

常见但无效的做法:

  1. 75% 失败

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

  2. 90% 失败

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