{
  "id": "unity/addressable-download-timeout",
  "signature": "UnityEngine.AddressableAssets: Initialization failed: Failed to download remote catalog from 'https://cdn.example.com/catalog.json' - Timeout after 30 seconds",
  "signature_zh": "UnityEngine.AddressableAssets：初始化失败：从'https://cdn.example.com/catalog.json'下载远程目录失败 - 30秒后超时",
  "regex": "UnityEngine\\.AddressableAssets: Initialization failed: Failed to download remote catalog from '.*' - Timeout after \\d+ seconds",
  "domain": "unity",
  "category": "network_error",
  "subcategory": null,
  "root_cause": "Addressables system could not download the remote content catalog within the default timeout due to network issues or server unavailability.",
  "root_cause_type": "generic",
  "root_cause_zh": "Addressables系统由于网络问题或服务器不可用，无法在默认超时时间内下载远程内容目录。",
  "versions": [
    {
      "version": "1.21.14",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "1.22.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "1.19.9",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Increasing timeout in Addressables settings to 120 seconds",
      "why_fails": "Only masks the symptom; if network is fundamentally broken or server down, longer timeout still fails.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    },
    {
      "action": "Disabling remote catalogs entirely",
      "why_fails": "Prevents use of remote content, breaking core functionality for updates.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "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(); } };",
      "success_rate": 0.8,
      "how": "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(); } };",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use a local fallback catalog by setting 'Build Remote Catalog' to false in Addressables settings, and include catalog in initial build.",
      "success_rate": 0.75,
      "how": "Use a local fallback catalog by setting 'Build Remote Catalog' to false in Addressables settings, and include catalog in initial build.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "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(); } };",
    "Use a local fallback catalog by setting 'Build Remote Catalog' to false in Addressables settings, and include catalog in initial build."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.unity3d.com/Packages/com.unity.addressables@1.21/manual/RemoteContentDistribution.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.83,
  "fix_success_rate": 0.78,
  "resolvable": "partial",
  "first_seen": "2024-02-14",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}