# UnityEngine.AddressableAssets：初始化失败：无法从路径'Library/com.unity.addressables/aa/catalog.json'加载内容目录。异常：System.IO.FileNotFoundException

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

## 根因

Addressables内容目录文件丢失或未构建，通常是因为Addressables构建未运行或目录被删除。

## 版本兼容性

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

## 解决方案

1. ```
   通过Window > Asset Management > Addressables > Groups重建Addressables内容，然后点击'Build' > 'New Build' > 'Default Build Script'。
   ```
2. ```
   如果在构建的播放器中缺少目录，请确保在Addressables设置中启用'Build Remote Catalog'，并通过'Player Preload'将目录包含在构建中。
   ```

## 无效尝试

- **** — Manually creating a catalog.json file with dummy content causes deserialization errors because the format is specific to Addressables. (90% 失败率)
- **** — Copying a catalog.json from another project does not work because it contains references to assets specific to that project's groups. (85% 失败率)