使用ImageRenderer生成UIImage调用jpegData()报kCMPhotoError_UnsupportedPixelFormat错误

问题根源 #

你遇到的kCMPhotoError_UnsupportedPixelFormat [-16995]错误，本质是ImageRenderer默认渲染出的UIImage采用了带Alpha透明通道的像素格式（如RGBA），而JPEG编码标准不支持透明通道。

AirDrop能正常工作是因为它在分享流程中自动做了格式兼容转换，但Messages、Mail的系统组件不会自动处理这种不兼容格式，导致编码失败、图片不显示甚至崩溃。

解决方案 #

1. 渲染时直接指定无Alpha通道的格式

通过配置ImageRenderer的format参数，强制使用不包含Alpha通道的标准sRGB格式，同时确保你的SwiftUI视图有不透明的背景（如果原视图是透明的，添加一个纯色背景层）：

// 假设你的SwiftUI视图是contentView
let contentView = YourSwiftUIView()
    .background(Color.white) // 确保背景不透明，避免残留Alpha通道

let renderer = ImageRenderer(content: contentView)
renderer.format.scale = UIScreen.main.scale // 匹配屏幕分辨率
renderer.format.preferredRange = .standard // 指定使用标准sRGB（无Alpha）格式

guard let uiImage = renderer.uiImage else {
    // 处理渲染失败
    return
}

2. 手动转换像素格式（兜底方案）

如果第一步仍无法解决，手动将带Alpha通道的UIImage转换为纯RGB格式：

func convertToRGBCompatibleImage(_ image: UIImage) -> UIImage? {
    guard let sourceCGImage = image.cgImage else { return nil }
    
    let width = sourceCGImage.width
    let height = sourceCGImage.height
    let colorSpace = CGColorSpaceCreateDeviceRGB()
    // 使用无Alpha通道的RGB格式（跳过第一个分量，对应RGB顺序）
    let bitmapInfo = CGImageAlphaInfo.noneSkipFirst.rawValue
    
    // 创建兼容RGB格式的绘图上下文
    guard let context = CGContext(
        data: nil,
        width: width,
        height: height,
        bitsPerComponent: 8,
        bytesPerRow: width * 4,
        space: colorSpace,
        bitmapInfo: bitmapInfo
    ) else { return nil }
    
    // 绘制原图到新上下文
    context.draw(sourceCGImage, in: CGRect(x: 0, y: 0, width: width, height: height))
    
    guard let convertedCGImage = context.makeImage() else { return nil }
    return UIImage(
        cgImage: convertedCGImage,
        scale: image.scale,
        orientation: image.imageOrientation
    )
}

// 使用示例
if let renderedImage = renderer.uiImage,
   let rgbImage = convertToRGBCompatibleImage(renderedImage) {
    // 现在调用jpegData不会报错
    if let jpegData = rgbImage.jpegData(compressionQuality: 0.8) {
        // 处理JPEG数据
    }
}

3. 分享时的优化

使用UIActivityViewController分享时，建议直接传入转换后的JPEG数据，避免系统再次尝试编码不兼容的UIImage：

if let jpegData = rgbImage.jpegData(compressionQuality: 0.8) {
    let activityVC = UIActivityViewController(
        activityItems: [jpegData],
        applicationActivities: nil
    )
    // 弹出分享界面
    present(activityVC, animated: true)
}

为什么转CGImage再创建UIImage没用？ #

你之前尝试的转CGImage再生成UIImage，本质只是格式容器的转换，原CGImage的像素格式（带Alpha通道）并没有改变，所以依然不兼容JPEG编码器。

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