Unity material.SetColor在PC/Android构建版本中失效问题咨询

核心原因及对应解决方法 #

• Standard Shader透明变体被构建时自动剥离
  Unity在打包时会自动剔除未在场景、资源中显式使用的Shader变体，你的代码是运行时动态开启_ALPHABLEND_ON关键字切换透明模式，若项目中没有任何材质显式设置为Standard Shader的Alpha Blend模式，该模式对应的Shader变体就会被剔除，构建版本中没有对应渲染逻辑所以失效。编辑器模式下不会执行变体剥离逻辑，因此运行正常。
  解决方法：
  1. 在项目中新建一个使用Standard Shader Alpha Blend模式的材质，放入Resources文件夹，保证打包时不会被剔除
  2. 前往Project Settings > Graphics > Preloaded Shaders，将Standard Shader添加到列表中，强制加载其所有变体
  3. 使用Shader Variant Collection收集需要用到的透明变体，添加到预加载列表中
• SRP合批限制导致动态修改材质属性失效
  如果你的项目开启了SRP Batcher（URP/HDRP项目默认开启，内置管线也可手动开启），SRP合批规则禁止运行时动态修改同Shader材质的渲染状态参数（包括混合模式、渲染队列、ZWrite等），修改后不会生效。
  解决方法：
  1. 给需要动态修改透明度的材质开启Enable GPU Instancing选项，避开SRP合批的限制
  2. 提前准备好不透明、透明两套材质，运行时直接切换材质而不是动态修改材质参数
• 材质参数设置不全/顺序错误
  你当前代码没有处理ZWrite状态，Standard Shader切换到Alpha Blend模式时需要关闭ZWrite，否则透明物体会写入深度缓冲，遮挡后方的物体，看起来没有透明效果。同时你先设置颜色再修改渲染状态的顺序也可能导致第一帧的属性赋值异常。
  解决方法：修改SetMaterialProperties方法，调整参数顺序并补充ZWrite设置，示例修改如下：

private void SetMaterialProperties(Color color)
{
    foreach (var material in _materials)
    {
        // 先设置渲染状态
        material.SetFloat("_Mode", 3);
        material.SetInt("_SrcBlend", (int)UnityEngine.Rendering.BlendMode.SrcAlpha);
        material.SetInt("_DstBlend", (int)UnityEngine.Rendering.BlendMode.OneMinusSrcAlpha);
        material.SetInt("_ZWrite", 0); // 补充关闭深度写入
        material.EnableKeyword("_ALPHABLEND_ON");
        material.renderQueue = 3000;
        // 最后设置颜色
        material.SetColor("_Color", color);
    }
}

• 材质实例引用错误
  检查_materials变量的赋值来源，如果是提前缓存的MeshRenderer.sharedMaterials，部分平台下不允许运行时修改原始材质资产，会导致修改不生效。
  解决方法：在脚本的Awake或Start生命周期中，获取当前物体的MeshRenderer.materials（注意是实例化的materials而非共享的sharedMaterials）赋值给_materials变量，保证操作的是当前物体独有的材质实例。

内容的提问来源于stack exchange，提问作者Rotmayer