Metal API验证崩溃：离屏渲染加法混合代码报错求助

你遇到的这个崩溃，核心原因非常明确——你用来做离屏渲染目标的纹理，没有被赋予MTLTextureUsageRenderTarget的使用权限。错误日志里的0x02对应的是MTLTextureUsageShaderRead，这说明当前纹理只允许被着色器读取，但要把它作为渲染目标写入，必须明确开启.renderTarget权限。

问题根源 #

在Metal中，所有纹理的用途都是显式声明的，创建纹理时必须通过MTLTextureDescriptor的usage属性指定它能做什么（比如渲染目标、着色器读取、数据写入等）。你的代码只配置了渲染管线的混合规则，却忽略了离屏纹理创建时的这个关键参数，导致Metal验证层检测到权限不匹配，直接触发断言崩溃。

解决方案 #

修改你创建离屏纹理的代码，确保在MTLTextureDescriptor中添加.renderTarget权限。如果之后你还需要从这个纹理读取数据（比如渲染到屏幕），记得同时加上.shaderRead：

// 创建离屏纹理的描述符
let offscreenTextureDesc = MTLTextureDescriptor.texture2DDescriptor(
    pixelFormat: .bgra8Unorm,
    width: yourTargetWidth,
    height: yourTargetHeight,
    mipmapped: false
)
// 必须包含.renderTarget才能作为渲染目标使用，.shaderRead用于后续读取纹理数据
offscreenTextureDesc.usage = [.renderTarget, .shaderRead]

// 创建纹理
guard let offscreenTexture = device.makeTexture(descriptor: offscreenTextureDesc) else {
    fatalError("Failed to create offscreen texture")
}

关于混合效果的确认 #

你在Metal中配置的混合参数是完全正确的，和你想要的OpenGL ES效果一一对应：

• Metal的rgbBlendOperation = .add → OpenGL ES的glBlendEquation(GL_FUNC_ADD)
• Metal的sourceRGBBlendFactor = .one + destinationRGBBlendFactor = .one → OpenGL ES的glBlendFunc(GL_ONE, GL_ONE)

这部分代码不需要修改，只要解决纹理权限问题，就能正常实现加法混合的离屏渲染效果。

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