macCatalyst随机触发SIGABRT Metal对象提前销毁崩溃如何排查

问题表现 #

macCatalyst应用出现随机崩溃，崩溃多触发于MapView展示场景，其他场景偶发，初步排查和MapView代码控制的缩放动画相关，错误日志如下：

-[MTLDebugDevice notifyExternalReferencesNonZeroOnDealloc:]:2951: failed assertion `The following Metal object is being destroyed while still required to be alive by the command buffer 0x7f8cd811c600 (label: <no label set>):
<MTLToolsObject: 0x7f8b0f9e3d60> -> <MTLIGAccelTexture: 0x7f8cd8566a00>
    label = CAMetalLayer Drawable 
    textureType = MTLTextureType2D 
    pixelFormat = MTLPixelFormatBGRA8Unorm_sRGB 
width = 772 
height = 1372 
depth = 1 
arrayLength = 1 
mipmapLevelCount = 1 
sampleCount = 1 
cpuCacheMode = MTLCPUCacheModeDefaultCache 
storageMode = MTLStorageModeManaged 
hazardTrackingMode = MTLHazardTrackingModeTracked 
resourceOptions = MTLResourceCPUCacheModeDefaultCache MTLResourceStorageModeManaged MTLResourceHazardTrackingModeTracked  
usage = MTLTextureUsageShaderRead MTLTextureUsageShaderWrite MTLTextureUsageRenderTarget MTLTextureUsagePixelFormatView 
shareable = 0 
framebufferOnly = 0 
purgeableState = MTLPurgeableStateNonVolatile 
swizzle = [MTLTextureSwizzleRed, MTLTextureSwizzleGreen, MTLTextureSwizzleBlue, MTLTextureSwizzleAlpha] 
isCompressed = 0 
parentTexture = <null> 
parentRelativeLevel = 0 
parentRelativeSlice = 0 
buffer = <null> 
bufferOffset = 0 
bufferBytesPerRow = 0 
iosurface = 0x600002533060 
iosurfacePlane = 0 
allowGPUOptimizedContents = YES'

错误本质 #

Metal渲染所用的CAMetalLayer Drawable纹理对象在GPU命令缓冲区仍在使用时就被提前释放，属于GPU资源生命周期管理错误，和内存不足、屏幕渲染视图数量过多无直接关联。

根因定位方向 #

• macCatalyst对UIKit MapKit的适配缺陷：MapView缩放动画执行过程中，系统内部Metal渲染管线未正确持有Drawable纹理，若此时触发视图层级变更、页面跳转或Map自身重绘逻辑，就会导致纹理被提前回收，触发断言崩溃。
• 自定义Metal渲染逻辑问题：如果应用内存在自定义CAMetalLayer绘制代码，检查是否存在drawable提前释放、command buffer未添加完成回调就提前释放关联资源的问题。
• Intel架构Metal驱动特性：Intel架构Mac的Metal驱动对Managed存储模式的纹理生命周期校验比ARM架构更严格，32GB内存可排除内存不足触发资源强制回收的可能。

排查手段 #

• 开启Xcode的Metal API Validation功能，复现崩溃时可获取完整的资源调用堆栈，精准定位触发纹理提前释放的代码位置。
• 给MapView相关动画操作绑定生命周期：缩放动画执行期间持有MapView强引用，动画结束后再解除持有，避免动画过程中MapView被提前回收导致内部资源释放。
• 核查缩放动画实现方式：如果使用UIView.animate封装MapView缩放操作，替换为MapKit原生的setRegion(_:animated:)或setCamera(_:animated:)接口，避免自定义动画和系统Map内部渲染逻辑冲突。

可行修复方案 #

• 临时方案：禁用MapView缩放动画，无动画触发就不会出现渲染过程中资源异步释放的冲突。
• 永久修复方案：若确认是macCatalyst自身MapKit适配Bug，可在Release环境下关闭Metal Debug层校验，避免系统断言触发崩溃，代码示例如下：

#if !DEBUG
ProcessInfo.processInfo.environment["MTL_DEBUG_LAYER"] = "0"
ProcessInfo.processInfo.environment["MTL_DEBUG_DEVICE"] = "0"
#endif

#ifndef DEBUG
setenv("MTL_DEBUG_LAYER", "0", 1);
setenv("MTL_DEBUG_DEVICE", "0", 1);
#endif

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