unity config_error ai_generated true

ArgumentException: The current render pipeline is incompatible with the material 'DefaultMaterial'

ID: unity/rendering-pipeline-asset-missing

Also available as: JSON · Markdown · 中文
90%Fix Rate
85%Confidence
1Evidence
2023-06-15First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
Unity 2022.3 active — — —
Unity 2023.1 active — — —
Unity 2021.3 active — — —

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.

generic

中文

材质的着色器期望特定的渲染管线（如URP或HDRP），但项目配置了不同的管线，或者图形设置中缺少管线资源。

Official Documentation

https://docs.unity3d.com/Manual/srp-setting-default-pipeline.html

Workarounds

  1. 95% success 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). 
    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).
  2. 85% success 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. 
    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.
  3. 75% success For custom shaders, add #pragma require derivatives or appropriate pipeline tags to make them compatible, or use a fallback shader. 
    For custom shaders, add #pragma require derivatives or appropriate pipeline tags to make them compatible, or use a fallback shader.

中文步骤

  1. 在编辑 > 项目设置 > 图形 > 脚本化渲染管线设置中分配正确的渲染管线资源（例如URP-HighQuality或HDRP）。如果不存在，通过资源 > 创建 > 渲染 > 通用渲染管线 > 管线资源（对于URP）创建。
  2. 如果材质来自包，确保包版本与安装的管线匹配。对于URP，将材质的着色器添加到图形设置中的始终包含的着色器列表中。
  3. 对于自定义着色器，添加#pragma require derivatives或适当的管线标签使其兼容，或使用回退着色器。

Dead Ends

Common approaches that don't work:

  1. 95% fail

    The material is not corrupted; the issue is a pipeline mismatch. Reimporting does not change the shader compatibility.

  2. 70% fail

    While this might remove the error, it bypasses the intended rendering pipeline and can cause visual inconsistencies or lost features.

  3. 80% fail

    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.