iOS17/18中UITableViewCell嵌入SwiftUI时TapGesture偶发失效求助

核心问题分析 #

当前代码每次调用update时都会创建新的UIHostingController并添加到contentView，但未移除旧实例，导致视图层级堆积。iOS 17+的触摸事件传递机制对这种重复添加的视图兼容性变差，进而引发TapGesture偶发无响应。

解决方案 #

1. 复用UIHostingController，避免重复创建 #

修改createSwiftUIContent方法，优先复用已有的UIHostingController，仅更新其rootView，而非每次创建新实例：

class RCBaseMessageCell: UITableViewCell {
    private var hostingController: UIHostingController<AnyView>?
    private var parentViewModel: RCConversationViewModel?
    
    fileprivate func createSwiftUIContent(_ parentViewModel: RCConversationViewModel,_ viewModel: RCMessageViewModel) {
        self.selectionStyle = .none
        let customContentView = MessageFactory.createMessage(type: viewModel.message.type, viewModel: viewModel)
        let wrappedView = AnyView(customContentView)
        
        if let existingHost = self.hostingController {
            // 复用已有控制器，更新rootView
            existingHost.rootView = wrappedView
        } else {
            // 首次创建并添加约束
            let hostingController = UIHostingController(rootView: wrappedView)
            hostingController.view.translatesAutoresizingMaskIntoConstraints = false
            self.hostingController = hostingController
            self.contentView.addSubview(hostingController.view)
            
            NSLayoutConstraint.activate([
                hostingController.view.leadingAnchor.constraint(equalTo: self.contentView.leadingAnchor),
                hostingController.view.trailingAnchor.constraint(equalTo: self.contentView.trailingAnchor),
                hostingController.view.topAnchor.constraint(equalTo: self.contentView.topAnchor),
                hostingController.view.bottomAnchor.constraint(equalTo: self.contentView.bottomAnchor),
            ])
        }
        
        self.hostingController?.view.backgroundColor = UIColor.clear
    }
    
    func update(parentViewModel: RCConversationViewModel, message: ChatMessage_ChatMessage, index: Int) {
        self.parentViewModel = parentViewModel
        let viewModel = RCMessageViewModel(message: message,parentViewModel: parentViewModel)
        viewModel.index = index
        createSwiftUIContent(parentViewModel, viewModel)
        
        self.contentView.backgroundColor = UIColor.clear
        self.backgroundColor = UIColor.clear
    }
}

2. 强制确保触摸事件传递 #

如果复用控制器后仍有问题，重写cell的hitTest方法，让触摸事件优先传递给SwiftUI视图容器：

override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
    guard let hostingView = hostingController?.view else {
        return super.hitTest(point, with: event)
    }
    let convertedPoint = convert(point, to: hostingView)
    if hostingView.point(inside: convertedPoint, with: event) {
        return hostingView.hitTest(convertedPoint, with: event)
    }
    return super.hitTest(point, with: event)
}

3. 改用轻量封装的SwiftUI容器视图 #

创建专门的UIView子类封装UIHostingController，统一管理其生命周期：

// 封装SwiftUI视图的容器类
class SwiftUIContainerView: UIView {
    private var hostingController: UIHostingController<AnyView>?
    
    func updateContent<Content: View>(_ content: Content) {
        hostingController?.view.removeFromSuperview()
        let newHost = UIHostingController(rootView: AnyView(content))
        newHost.view.translatesAutoresizingMaskIntoConstraints = false
        hostingController = newHost
        addSubview(newHost.view)
        
        NSLayoutConstraint.activate([
            newHost.view.leadingAnchor.constraint(equalTo: leadingAnchor),
            newHost.view.trailingAnchor.constraint(equalTo: trailingAnchor),
            newHost.view.topAnchor.constraint(equalTo: topAnchor),
            newHost.view.bottomAnchor.constraint(equalTo: bottomAnchor),
        ])
        newHost.view.backgroundColor = .clear
    }
}

// 修改cell实现
class RCBaseMessageCell: UITableViewCell {
    private let swiftUIContainer = SwiftUIContainerView()
    private var parentViewModel: RCConversationViewModel?
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupCell()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupCell()
    }
    
    private func setupCell() {
        selectionStyle = .none
        contentView.addSubview(swiftUIContainer)
        swiftUIContainer.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
            swiftUIContainer.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            swiftUIContainer.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            swiftUIContainer.topAnchor.constraint(equalTo: contentView.topAnchor),
            swiftUIContainer.bottomAnchor.constraint(equalTo: contentView.bottomAnchor),
        ])
        
        contentView.backgroundColor = .clear
        backgroundColor = .clear
        swiftUIContainer.backgroundColor = .clear
    }
    
    func update(parentViewModel: RCConversationViewModel, message: ChatMessage_ChatMessage, index: Int) {
        self.parentViewModel = parentViewModel
        let viewModel = RCMessageViewModel(message: message, parentViewModel: parentViewModel)
        viewModel.index = index
        let customContentView = MessageFactory.createMessage(type: viewModel.message.type, viewModel: viewModel)
        swiftUIContainer.updateContent(customContentView)
    }
}

4. 明确开启交互开关 #

在cell初始化时强制设置交互属性，避免系统默认值在iOS17+中异常：

private func setupCell() {
    selectionStyle = .none
    isUserInteractionEnabled = true
    contentView.isUserInteractionEnabled = true
    // ... 其他初始化代码
}

验证建议 #

• 测试iOS17、iOS18.1版本下的触摸响应情况
• 开启Xcode视图层级调试（Debug View Hierarchy），确认cell中无重复的UIHostingController视图

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