# UnityEngine.AddressableAssets: 初始化失败: 无法从路径加载内容目录

- **ID:** `unity/addressable-catalog-load-failed`
- **领域:** unity
- **类别:** io_error
- **验证级别:** ai_generated
- **修复率:** 92%

## 根因

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

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Unity 2022.3 | active | — | — |
| Unity 2023.1 | active | — | — |
| Addressables 1.21.0 | active | — | — |
| Addressables 1.22.0 | active | — | — |

## 解决方案

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.
   ```

## 无效尝试

- **** — The catalog is generated during a build, not during import; a fresh Addressables build is required. (75% 失败率)
- **** — Addressables uses hash files to verify integrity; manual copy bypasses hash generation. (90% 失败率)