iOS 17+版本React Native应用突发NSInternalInconsistencyException错误求助

问题根源 #

这个NSInternalInconsistencyException崩溃是因为调用UIGraphicsBeginImageContext()或UIGraphicsBeginImageContextWithOptions()时传入了**{0, 0}的无效尺寸**。iOS 17开始对这种场景新增了断言检查，之前版本可能仅静默忽略，现在直接触发崩溃，系统提示的UIGraphicsImageRenderer是Apple推荐的现代绘图API，能从根源避免这类问题。

定位第三方库问题 #

• 添加异常断点：在Xcode中创建「Exception Breakpoint」，崩溃触发时查看调用栈，直接定位到调用无效尺寸的第三方库代码位置。
• 全局搜索API：在项目中全局搜索UIGraphicsBeginImageContext或UIGraphicsBeginImageContextWithOptions，筛选第三方库目录下的匹配结果，排查是否有传0尺寸的情况。
• 符号断点追踪：添加符号断点，符号设为UIGraphicsBeginImageContextWithOptions，触发时查看调用栈的上层调用者，锁定问题库。

临时修复（无需更新库） #

通过方法交换（Method Swizzling）拦截无效调用，避免崩溃：

@implementation UIGraphicsContext (SafeInit)
+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        Class cls = object_getClass(self);
        SEL originalSel = @selector(beginImageContextWithOptions:);
        SEL swizzledSel = @selector(safe_beginImageContextWithOptions:);
        
        Method originalMethod = class_getClassMethod(cls, originalSel);
        Method swizzledMethod = class_getClassMethod(cls, swizzledSel);
        
        BOOL added = class_addMethod(cls, originalSel, method_getImplementation(swizzledMethod), method_getTypeEncoding(swizzledMethod));
        if (added) {
            class_replaceMethod(cls, swizzledSel, method_getImplementation(originalMethod), method_getTypeEncoding(originalMethod));
        } else {
            method_exchangeImplementations(originalMethod, swizzledMethod);
        }
    });
}

+ (void)safe_beginImageContextWithOptions:(CGSize)size {
    if (size.width <= 0 || size.height <= 0) {
        NSLog(@"⚠️ 尝试创建无效尺寸的图像上下文：%@", NSStringFromCGSize(size));
        return;
    }
    [self safe_beginImageContextWithOptions:size];
}
@end

Swift版本可通过extension UIGraphicsImageRenderer或类似方式实现方法交换。

长期解决方案 #

• 升级第三方库：找到问题库后，查看其官方仓库的更新日志，优先升级到修复了iOS 17兼容性的版本。
• 替换API：如果库已停止维护，可修改库代码，将旧的UIGraphicsBeginImageContext系列API替换为UIGraphicsImageRenderer：
  旧代码：

  UIGraphicsBeginImageContext(imageSize);
  // 绘图逻辑
  UIImage *result = UIGraphicsGetImageFromCurrentImageContext();
  UIGraphicsEndImageContext();
  

  新代码：

  UIGraphicsImageRenderer *renderer = [[UIGraphicsImageRenderer alloc] initWithSize:imageSize];
  UIImage *result = [renderer imageWithActions:^(UIGraphicsImageRendererContext *context) {
      // 使用context.CGContext执行绘图逻辑
  }];
  

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