真机上父视图边界外视图的手势事件无法触发问题求助

问题背景 #

绑定在navigationItem.titleView的自定义UIView中有个超出父视图范围的头像视图，需要点击它触发手势识别器实现图片放大动画。已经重写point(inside:with:)方法返回true，甚至直接在方法内调用触发逻辑，模拟器正常，但真机上point(inside:with:)完全没触发，试过hitTest(_:with:)也没用。

调试建议 #

• 检查导航栏触摸限制：真机上系统对导航栏子视图的触摸范围约束更严格，尝试给CustomTitleView设置更大的intrinsicContentSize，或手动调整frame让父视图范围覆盖头像区域。
• 关闭视图裁剪：确保CustomTitleView和导航栏的clipsToBounds都设为false，真机部分场景下默认裁剪会导致超出区域无法响应触摸。
• 正确重写hitTest方法：hitTest是触摸事件传递的核心，正确实现才能让超出父视图的子视图响应触摸，示例代码：

override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
    if !isUserInteractionEnabled || isHidden || alpha <= 0.01 {
        return nil
    }
    // 先检查自身范围内的触摸
    if self.point(inside: point, with: event) {
        for subview in subviews.reversed() {
            let convertedPoint = subview.convert(point, from: self)
            if let hitView = subview.hitTest(convertedPoint, with: event) {
                return hitView
            }
        }
        return self
    }
    // 额外检查超出父视图的头像
    let imagePoint = profileImage.convert(point, from: self)
    if profileImage.point(inside: imagePoint, with: event) {
        return profileImage
    }
    return nil
}

• 调整视图层级：如果titleView的触摸限制无法绕过，可直接将头像视图添加到navigationController?.navigationBar上，通过约束定位到titleView旁，脱离titleView的范围限制。
• 真机可视化调试：用Xcode的Debug View Hierarchy查看视图层级，确认头像实际frame是否正确；给CustomTitleView和头像添加背景色，直观检查视图范围是否覆盖触摸区域。
• 规范事件处理逻辑：point(inside:with:)仅用于判断触摸点是否在视图范围内，直接在这里调用动画会打破触摸事件的正常流程，应让手势识别器自行处理触发。

测试代码 #

import UIKit

class ViewController: UIViewController {

    let button = UIButton()

    override func viewDidLoad() {
        super.viewDidLoad()
        setupButton()
    }

    func setupButton() {
        view.addSubview(button)
        view.backgroundColor = .brown
        button.setTitle("next", for: .normal)
        button.backgroundColor = .green
        button.translatesAutoresizingMaskIntoConstraints = false
        button.addTarget(self, action: #selector(pushToNavVC), for: .touchUpInside)
        
        NSLayoutConstraint.activate([
            button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            button.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            button.widthAnchor.constraint(equalToConstant: 50),
            button.heightAnchor.constraint(equalToConstant: 50),
        ])
    }

    @objc func pushToNavVC() {
        let secondVc = SecondViewController()
        navigationController?.pushViewController(secondVc, animated: true)
    }
}

class SecondViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .brown
        setupNavigationBar()
    }

    private func setupNavigationBar() {
        let titleView = CustomTitleView(name: "John Doe", lastSeen: "Last seen 5 min ago")
        navigationItem.titleView = titleView
    }
}


class CustomTitleView: UIView {
    let nameLabel: UILabel
    let lastSeenLabel: UILabel
    let profileImage: UIImageView!

    private var temporaryDimmView: UIView!
    private var temporaryImageView: UIView!
    
    init(name: String, lastSeen: String) {
        nameLabel = UILabel()
        lastSeenLabel = UILabel()
        profileImage = UIImageView()
        
        super.init(frame: .zero)
        
        setupViews(name: name, lastSeen: lastSeen)
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    private func setupViews(name: String, lastSeen: String) {
        nameLabel.text = name
        nameLabel.font = UIFont.boldSystemFont(ofSize: 16)
        
        lastSeenLabel.text = lastSeen
        lastSeenLabel.font = UIFont.systemFont(ofSize: 12)
        lastSeenLabel.textColor = .gray
        
        profileImage.image = UIImage(named: "your_image_name_here")
        profileImage.translatesAutoresizingMaskIntoConstraints = false
        profileImage.isUserInteractionEnabled = true
        
        let imageTapGesture = UITapGestureRecognizer(target: self, action: #selector(animateProfileImage))
        profileImage.addGestureRecognizer(imageTapGesture)
        
        let stackView = UIStackView(arrangedSubviews: [nameLabel, lastSeenLabel])
        stackView.axis = .vertical
        stackView.alignment = .center
        
        addSubview(stackView)
        addSubview(profileImage)
        
        stackView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            stackView.topAnchor.constraint(equalTo: topAnchor),
            stackView.bottomAnchor.constraint(equalTo: bottomAnchor),
            stackView.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 40),
            stackView.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -40),
            
            profileImage.trailingAnchor.constraint(equalTo: trailingAnchor, constant: 50),
            profileImage.widthAnchor.constraint(equalToConstant: 30),
            profileImage.heightAnchor.constraint(equalToConstant: 30),
            profileImage.centerYAnchor.constraint(equalTo: centerYAnchor),
            widthAnchor.constraint(equalToConstant: 200)
        ])
    }

    @objc func animateProfileImage() {
        guard let window = window else { return }
        temporaryDimmView = setupTemporaryDimmView(withFrame: window.frame)
        temporaryImageView = setupTemporaryImageView()
        
        UIView.animate(withDuration: 0.5, animations: {
            self.profileImage.isHidden = true
            self.temporaryImageView.center = window.center
            self.temporaryImageView.transform = CGAffineTransform(scaleX: 8, y: 8)
            self.temporaryDimmView.alpha = 0.85
        })
    }

    @objc func dismissProfileImage(_ sender: UITapGestureRecognizer) {

        let imageFrame = profileImage.convert(profileImage.bounds, to: window)
        
        UIView.animate(withDuration: 0.5) {
            self.temporaryDimmView.alpha = 0
            self.temporaryImageView.transform.a = 1
            self.temporaryImageView.transform.d = 1
            self.temporaryImageView.frame.origin = imageFrame.origin
        } completion: { _ in
            self.temporaryDimmView.removeFromSuperview()
            self.temporaryImageView.removeFromSuperview()
            self.temporaryDimmView = nil
            self.temporaryImageView = nil
            self.profileImage.isHidden = false
        }
    }

    /// 按现有认知，这个方法应该能触发超出父视图范围的子视图手势
    /// 但当前场景无效，所以直接在内部调用animateProfileImage()
    override func point(inside point: CGPoint, with event: UIEvent?) -> Bool
    {
        if super.point(inside: point, with: event) {return true}
        
        for subview in subviews {
            let subviewPoint = subview.convert(point, from: self)
            if subview.point(inside: subviewPoint, with: event) {
                animateProfileImage()
                return true
            }
        }
        return false
    }
}

// 图片动画启动时创建临时视图的工具方法
extension CustomTitleView {
    private func setupTemporaryImageView() -> UIView {
        let imageFrame = profileImage.convert(profileImage.bounds, to: window)
        let animatedImageView = UIImageView(frame: imageFrame)
        animatedImageView.image = profileImage.image
        animatedImageView.contentMode = .scaleAspectFill
        window?.addSubview(animatedImageView)
        
        return animatedImageView
    }

    private func setupTemporaryDimmView(withFrame frame: CGRect) -> UIView {
        let dimmView = UIView(frame: frame)
        dimmView.backgroundColor = .black
        dimmView.alpha = 0
        window?.addSubview(dimmView)
        
        let tapGesture = UITapGestureRecognizer(target: self, action: #selector(dismissProfileImage))
        dimmView.addGestureRecognizer(tapGesture)
        
        return dimmView
    }
}

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