iOS Swift：unrecognized selector sent to instance 錯誤完整排查指南

錯誤含義

unrecognized selector sent to instance 表示執行期嘗試呼叫一個物件不存在的方法。常見於 Target-Action 機制、Delegate、Notification、KVO 等動態派發場景。

最常見的 5 大原因與解法

快速除錯步驟

1. 在 Crash 該行設中斷點，查看 po $arg1（Target）與 po $arg2（Selector）。
2. Console 執行 po [target respondsToSelector:selector] 驗證方法是否存在。
3. 啟用 Zombie Objects（Scheme → Diagnostics → Enable Zombie Objects）偵測已釋放物件。

現代 Swift 最佳實踐

• 優先使用 Closure / Combine / Async-Await 取代 Target-Action，編譯期型別安全。
• 若必須用 Selector，統一用 #selector(ViewController.methodName(_:)) 寫法，重構時自動重命名。
• 按鈕事件改用 addAction(UIAction(handler: { _ in ... }), for: .touchUpInside)（iOS 14+），完全避開 Selector。

總結

「未識別的選擇器」本質是動態派發與靜態定義不匹配。善用 Swift 編譯期檢查（#selector、@objc）、Zombie 偵測與現代 API，可將此類崩潰降為零。