{
  "id": "unity/addressable-catalog-load-failure",
  "signature": "UnityEngine.AddressableAssets: Initialization failed: Failed to load content catalog from path 'Library/com.unity.addressables/aa/catalog.json'. Exception: System.IO.FileNotFoundException",
  "signature_zh": "UnityEngine.AddressableAssets：初始化失败：无法从路径'Library/com.unity.addressables/aa/catalog.json'加载内容目录。异常：System.IO.FileNotFoundException",
  "regex": "UnityEngine\\.AddressableAssets: Initialization failed: Failed to load content catalog from path '.*?catalog\\.json'\\. Exception: System\\.IO\\.FileNotFoundException",
  "domain": "unity",
  "category": "io_error",
  "subcategory": null,
  "root_cause": "The Addressables content catalog file is missing or not built, often because the Addressables build was not run or the catalog was deleted.",
  "root_cause_type": "generic",
  "root_cause_zh": "Addressables内容目录文件丢失或未构建，通常是因为Addressables构建未运行或目录被删除。",
  "versions": [
    {
      "version": "Unity 2022.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Addressables 1.21.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Unity 2023.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Manually creating a catalog.json file with dummy content causes deserialization errors because the format is specific to Addressables.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Copying a catalog.json from another project does not work because it contains references to assets specific to that project's groups.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.",
      "success_rate": 0.95,
      "how": "Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.",
      "condition": "",
      "sources": []
    },
    {
      "action": "If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.",
      "success_rate": 0.9,
      "how": "If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "通过Window > Asset Management > Addressables > Groups重建Addressables内容，然后点击'Build' > 'New Build' > 'Default Build Script'。",
    "如果在构建的播放器中缺少目录，请确保在Addressables设置中启用'Build Remote Catalog'，并通过'Player Preload'将目录包含在构建中。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.unity3d.com/Packages/com.unity.addressables@1.21/manual/InitializeAsync.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.87,
  "fix_success_rate": 0.93,
  "resolvable": "true",
  "first_seen": "2023-09-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}