Unity升级至2022.3/Gradle7x后出现黑屏及GetGpuPixelFormat错误求助

问题概述 #

Unity升级至2022.3版本后，同步升级Gradle插件至7.1.2、Gradle版本至7x，且移除了gradle.properties中的android.enableR8（该功能默认开启），随后出现闪屏结束后黑屏的问题（非致命崩溃）。Logcat核心报错如下：

Error qdgralloc GetGpuPixelFormat: No map for format: 0x38
Error AdrenoUtils <validate_memory_layout_input_parmas:1923>: Unknown Format 0
Error AdrenoUtils <adreno_init_memory_layout:4634>: Memory Layout input parameter validation failed!
Error qdgralloc GetGpuResourceSizeAndDimensions Graphics metadata init failed
Error Gralloc4 isSupported(1, 1, 56, 1, ...) failed with 1
Error GraphicBufferAllocator Failed to allocate (4 x 4) layerCount 1 format 56 usage b00: 1
Error AHardwareBuffer GraphicBuffer(w=4, h=4, lc=1) failed (Unknown error -1), handle=0x0

其中0x38对应Android的R_8单通道像素格式，仅Android端出现问题，iOS运行正常；新项目无异常，但复制主项目资产（含Gradle文件）后问题重现，且部分场景的UI纹理加载失败。

核心原因 #

问题指向R_8单通道纹理格式在Adreno GPU+Gradle 7x的环境下存在兼容性异常，大概率是Unity纹理导入设置与Gradle R8优化的冲突，导致纹理格式处理逻辑出错。

可行解决方案 #

1. 强制修改UI纹理的像素格式 #

针对所有UI纹理，统一调整导入设置，规避R_8格式：

• 在Unity Inspector面板中，选中UI纹理，将Format从Automatic或R8改为RGBA32或RGB24
• 勾选Override for Android，确保仅对Android端生效
• 可使用以下Editor脚本批量修改，提高效率：

using UnityEditor;
using UnityEngine;

public class UITextureFormatFixer : EditorWindow
{
    [MenuItem("Tools/Batch Fix UI Texture Formats")]
    public static void OpenToolWindow()
    {
        GetWindow<UITextureFormatFixer>("UI Texture Format Fixer");
    }

    private void OnGUI()
    {
        if (GUILayout.Button("Fix All UI Textures"))
        {
            // 仅扫描UI目录下的纹理，可根据项目路径调整
            string[] textureGuids = AssetDatabase.FindAssets("t:Texture2D", new[] { "Assets/UI" });
            int fixedCount = 0;
            foreach (string guid in textureGuids)
            {
                string assetPath = AssetDatabase.GUIDToAssetPath(guid);
                TextureImporter importer = AssetImporter.GetAtPath(assetPath) as TextureImporter;
                if (importer != null && importer.textureType == TextureImporterType.Sprite)
                {
                    importer.SetPlatformTextureSettings("Android", 2048, TextureImporterFormat.RGBA32);
                    importer.SaveAndReimport();
                    fixedCount++;
                }
            }
            Debug.Log($"Fixed {fixedCount} UI textures!");
        }
    }
}

2. 添加Gradle R8优化豁免规则 #

避免纹理相关代码被R8错误优化：

• 在Unity项目的Assets/Plugins/Android目录下创建proguard-rules.pro文件
• 写入以下规则：

# 保留Unity纹理处理相关类不被混淆
-keep class com.unity3d.player.UnityPlayerTexture** { *; }
# 保留Android像素格式定义类
-keep class android.graphics.PixelFormat { *; }

• 在Unity的Player Settings > Publishing Settings > Build中，勾选Custom Proguard File选项

3. 临时回退Gradle版本（验证用） #

若上述方案无效，可临时回退Gradle环境确认问题根源：

• 在Player Settings > Player > Android > Publishing Settings > Build中，设置Gradle Version为6.7.1，Gradle Plugin Version为4.0.1
• 恢复gradle.properties中的android.enableR8=false（此为临时验证方案，不建议长期使用）

4. 强制指定Android图形API #

进一步排除图形API兼容性问题：

• 在Player Settings > Graphics > Graphics APIs for Android中，禁用Auto Graphics API
• 仅保留OpenGLES3和OpenGLES2，并将OpenGLES3移至列表顶部

验证步骤 #

1. 应用方案后执行File > Build Settings > Clean Build清理缓存
2. 重新构建APK并安装测试
3. 检查Logcat是否仍存在GetGpuPixelFormat: No map for format: 0x38类报错

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