CGBitmapContext绘制文本及UIView渲染转MP4故障调试咨询

嘿，我之前做离线渲染转MP4的时候踩过几乎一模一样的坑，给你整理了针对性的调试思路，应该能帮你逐个击破这些问题：

一、图像旋转问题 #

• 先确认CGBitmapContext的坐标系匹配：UIView的drawRect上下文默认是屏幕坐标系（原点在左上角），但CGBitmapContext用的是Core Graphics默认坐标系（原点在左下角），这是最常见的旋转原因。你可以在创建bitmap上下文后手动翻转坐标系：

  CGContextTranslateCTM(bitmapContext, 0, bitmapHeight);
  CGContextScaleCTM(bitmapContext, 1.0, -1.0);
  

• 检查视频导出时的轨道方向设置：如果翻转上下文后还是有旋转，要确保AVAssetWriterInput的transform属性和渲染图像的方向匹配。比如竖屏内容需要设置对应的CGAffineTransform来修正视频输出方向。
• 对比两个上下文的CTM矩阵：打印drawRect里的上下文和bitmap上下文的CGContextGetCTM()结果，看是否存在缩放或旋转的差异，快速定位坐标系问题。

二、渲染内容重复问题 #

• 强制清空bitmap上下文：如果复用同一个CGBitmapContext，每次渲染前必须用CGContextClearRect清空整个画布，否则上一帧的内容会残留。代码示例：

  CGContextClearRect(bitmapContext, CGRectMake(0, 0, bitmapWidth, bitmapHeight));
  

• 排查渲染逻辑的调用次数：给每帧渲染加个唯一ID日志，看后台渲染时是否同一帧的绘制逻辑被调用了多次，导致内容重复绘制。
• 检查视频帧的时间戳：如果AVAssetWriterInput的时间戳重复或间隔错误，播放器会重复显示同一帧。要确保每帧的时间戳严格递增，且符合帧率要求（比如30fps的话，每帧间隔1/30秒）。

三、随机噪点问题 #

• 确认像素格式正确性：CGBitmapContext的像素格式必须和你的渲染内容匹配，比如用kCGImageAlphaPremultipliedFirst或kCGImageAlphaPremultipliedLast，避免因为格式不匹配导致内存读写错误。如果渲染带alpha的内容却用了不带alpha的格式，很容易出现随机噪点。
• 检查内存安全：用Xcode的Instruments工具（Zombies或Leaks模板）排查后台渲染时的内存泄漏或野指针问题，尤其是频繁创建/销毁上下文的场景，内存错误会导致随机绘制异常。
• 保证线程安全：Core Graphics上下文不是线程安全的，如果多线程同时操作同一个上下文，会出现随机的绘制错乱。要确保每个上下文在单一线程中使用，或者加锁保护渲染操作。

四、时序异常问题 #

• 控制渲染和写入的串行执行：如果后台渲染是异步任务，可能出现帧生成顺序和提交顺序不一致的情况。建议用串行队列来管理渲染和视频写入操作，确保帧按顺序生成并写入。
• 准确计算时间戳：不要用当前系统时间作为帧的时间戳（系统时间可能有波动），应该基于起始时间累加计算，比如：

  CMTime frameTime = CMTimeMakeWithSeconds(startTime + frameIndex / frameRate, preferredTimeScale);
  

• 监听AVAssetWriter状态：写入过程中如果出现磁盘空间不足、格式错误等问题，会导致帧丢失或时序错乱。记得监听AVAssetWriter的status属性和error属性，及时捕获异常。

另外，建议你先单独导出几帧静态图片（把CGBitmapContext转成UIImage保存），先确认静态帧是否有问题，再排查视频合成环节的问题——这样可以把渲染逻辑和视频导出逻辑分开调试，更容易定位根源。

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