将SwiftUI View转为UIImage渲染MKAnnotation时出错（iOS16）

错误原因 #

• 核心问题是你在prepareForDisplay方法中尝试渲染的SwiftUI视图尚未提交到系统渲染服务端。prepareForDisplay属于MKAnnotationView的早期生命周期阶段，此时承载SwiftUI视图的UIHostingView还未完成布局初始化与渲染上下文绑定，直接执行快照操作会触发系统的渲染限制。
• 旧的自定义快照逻辑依赖视图已挂载到视图层级并完成布局计算，而prepareForDisplay的执行时机不满足这个前提，因此抛出了不支持渲染未提交视图的错误。

iOS16适配方案 #

iOS16提供了官方的SwiftUI视图转图片API，可直接规避该问题，具体实现如下：

1. 使用iOS16新增的View.renderedImage()异步方法，该方法无需依赖宿主视图挂载，系统会自行处理渲染上下文：

override func prepareForDisplay() {
    super.prepareForDisplay()
    let pinView = LandmarkPin()
        .frame(width: 40, height: 40) // 务必给SwiftUI视图设置明确尺寸
    
    Task {
        let snapshotImage = await pinView.renderedImage()
        DispatchQueue.main.async {
            self.image = snapshotImage
        }
    }
}

2. 关键注意点：必须给待快照的SwiftUI视图设置固定frame，否则异步渲染无法确定视图尺寸，会导致快照内容异常。

额外提示 #

如果你的自定义扩展使用了UIHostingController手动挂载视图再快照的旧方案，在iOS16环境下会因为视图未提交到渲染服务端而报错，直接替换为官方异步API即可解决问题。

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