自定义UIView调用ViewController方法时Delegate无响应问题排查

这种代理没触发的问题我碰到过好多次，大概率是这几个环节出了疏漏，咱们一步步来排查：

1. 代理协议的定义是否规范 #

Swift 中给 UIKit 组件做代理时，必须保证协议是@objc兼容的，同时建议用AnyObject限定代理对象类型（避免循环引用）。比如：

@objc protocol CustomViewDelegate: AnyObject {
    func buttonDidTapped() // 自定义的代理方法
}

如果你的协议里有可选方法，还要加上@objc optional修饰方法。

2. 自定义UIView的代理属性是否用weak修饰 #

这是最容易踩的坑！如果代理属性用strong，会导致 ViewController 和 CustomView 形成循环引用，最终代理对象被异常释放，回调自然触发不了。正确的写法：

class CustomView: UIView {
    // 必须用weak，防止循环引用
    weak var delegate: CustomViewDelegate?
    
    @IBAction func buttonClicked(_ sender: UIButton) {
        // 先打印确认按钮点击事件本身是否触发
        print("CustomView 按钮已点击")
        delegate?.buttonDidTapped()
    }
}

3. ViewController是否正确设置了代理 #

很多人会忘记在 ViewController 里给 CustomView 绑定代理，或者没遵守代理协议。检查代码：

class ViewController: UIViewController, CustomViewDelegate {
    @IBOutlet weak var customView: CustomView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 关键步骤：把代理指向当前ViewController
        customView.delegate = self
    }
    
    // 实现代理方法
    func buttonDidTapped() {
        print("预期要打印的文本")
    }
}

注意：ViewController 必须显式声明遵守CustomViewDelegate协议，否则编译器会报错，或者代理设置不生效。

4. 按钮点击事件是否正确关联 #

如果上面的步骤都没问题，但按钮点击时连CustomView 按钮已点击都没打印，那就是按钮的点击事件没绑定成功：

• 用 Storyboard/XIB 的话，检查按钮的Touch Up Inside事件是否正确拖到了 CustomView 的buttonClicked方法上；
• 用纯代码创建按钮的话，确认调用了addTarget(_:action:for:)方法，且方法签名正确。

5. 排查代理是否被意外置为nil #

可以在 CustomView 的按钮点击方法里打印代理对象，确认是否为nil：

@IBAction func buttonClicked(_ sender: UIButton) {
    print("当前代理对象：\(delegate)")
    delegate?.buttonDidTapped()
}

如果输出nil，说明代理没设置成功，回去检查 ViewController 里的代理绑定逻辑，有没有在某个地方把customView.delegate意外设为nil。

按这个顺序排查下来，基本就能找到问题所在啦！

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