# UnityEngine.AddressableAssets：初始化失败：从'https://cdn.example.com/catalog.json'下载远程目录失败 - 30秒后超时

- **ID:** `unity/addressable-download-timeout`
- **领域:** unity
- **类别:** network_error
- **验证级别:** ai_generated
- **修复率:** 78%

## 根因

Addressables系统由于网络问题或服务器不可用，无法在默认超时时间内下载远程内容目录。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 1.21.14 | active | — | — |
| 1.22.0 | active | — | — |
| 1.19.9 | active | — | — |

## 解决方案

1. ```
   Check network connectivity and ensure CDN endpoint is reachable. In Addressables groups window, set 'Remote Catalog Load Path' to a valid URL. Add retry logic: Addressables.InitializeAsync().Completed += op => { if (op.Status == AsyncOperationStatus.Failed) { Debug.LogError("Retrying..."); Addressables.InitializeAsync(); } };
   ```
2. ```
   Use a local fallback catalog by setting 'Build Remote Catalog' to false in Addressables settings, and include catalog in initial build.
   ```

## 无效尝试

- **Increasing timeout in Addressables settings to 120 seconds** — Only masks the symptom; if network is fundamentally broken or server down, longer timeout still fails. (60% 失败率)
- **Disabling remote catalogs entirely** — Prevents use of remote content, breaking core functionality for updates. (70% 失败率)