{
  "id": "unity/rendering-pipeline-asset-missing",
  "signature": "ArgumentException: The current render pipeline is incompatible with the material 'DefaultMaterial'",
  "signature_zh": "ArgumentException: 当前渲染管线与材质'DefaultMaterial'不兼容",
  "regex": "ArgumentException: The current render pipeline is incompatible with the material",
  "domain": "unity",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "The material's shader expects a specific render pipeline (e.g., URP or HDRP) but the project is configured with a different pipeline, or the pipeline asset is missing from Graphics Settings.",
  "root_cause_type": "generic",
  "root_cause_zh": "材质的着色器期望特定的渲染管线（如URP或HDRP），但项目配置了不同的管线，或者图形设置中缺少管线资源。",
  "versions": [
    {
      "version": "Unity 2022.3",
      "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"
    },
    {
      "version": "Unity 2021.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The material is not corrupted; the issue is a pipeline mismatch. Reimporting does not change the shader compatibility.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "While this might remove the error, it bypasses the intended rendering pipeline and can cause visual inconsistencies or lost features.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "If the project assets (shaders, post-processing) are designed for URP/HDRP, switching to Built-in will break many effects and is often not a viable fix.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Assign the correct render pipeline asset (e.g., URP-HighQuality or HDRP) in Edit > Project Settings > Graphics > Scriptable Render Pipeline Settings. If none exists, create one via Assets > Create > Rendering > Universal Render Pipeline > Pipeline Asset (for URP).",
      "success_rate": 0.95,
      "how": "Assign the correct render pipeline asset (e.g., URP-HighQuality or HDRP) in Edit > Project Settings > Graphics > Scriptable Render Pipeline Settings. If none exists, create one via Assets > Create > Rendering > Universal Render Pipeline > Pipeline Asset (for URP).",
      "condition": "",
      "sources": []
    },
    {
      "action": "If the material is from a package, ensure the package version matches the installed pipeline. For URP, add the material's shader to the Always Included Shaders list in Graphics Settings.",
      "success_rate": 0.85,
      "how": "If the material is from a package, ensure the package version matches the installed pipeline. For URP, add the material's shader to the Always Included Shaders list in Graphics Settings.",
      "condition": "",
      "sources": []
    },
    {
      "action": "For custom shaders, add #pragma require derivatives or appropriate pipeline tags to make them compatible, or use a fallback shader.",
      "success_rate": 0.75,
      "how": "For custom shaders, add #pragma require derivatives or appropriate pipeline tags to make them compatible, or use a fallback shader.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "在编辑 > 项目设置 > 图形 > 脚本化渲染管线设置中分配正确的渲染管线资源（例如URP-HighQuality或HDRP）。如果不存在，通过资源 > 创建 > 渲染 > 通用渲染管线 > 管线资源（对于URP）创建。",
    "如果材质来自包，确保包版本与安装的管线匹配。对于URP，将材质的着色器添加到图形设置中的始终包含的着色器列表中。",
    "对于自定义着色器，添加#pragma require derivatives或适当的管线标签使其兼容，或使用回退着色器。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.unity3d.com/Manual/srp-setting-default-pipeline.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2023-06-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}