unity network_error ai_generated partial

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

UnityEngine.AddressableAssets: Initialization failed: Failed to download remote catalog from 'https://cdn.example.com/catalog.json' - Timeout after 30 seconds

ID: unity/addressable-download-timeout

其他格式: JSON · Markdown 中文 · English
78%修复率
83%置信度
1证据数
2024-02-14首次发现

版本兼容性

版本状态引入弃用备注
1.21.14 active — — —
1.22.0 active — — —
1.19.9 active — — —

根因分析

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

English

Addressables system could not download the remote content catalog within the default timeout due to network issues or server unavailability.

generic

官方文档

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

解决方案

  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.

无效尝试

常见但无效的做法:

  1. Increasing timeout in Addressables settings to 120 seconds 60% 失败

    Only masks the symptom; if network is fundamentally broken or server down, longer timeout still fails.

  2. Disabling remote catalogs entirely 70% 失败

    Prevents use of remote content, breaking core functionality for updates.