Я столкнулся с той же проблемой, когда у меня был UISearchBar внутри UIScrollView.Как я понимаю, вопрос у вас был внутри UITableView, который является подклассом UIScrollView.
В моем случае мне помогла установка
tableView.delaysContentTouches = NO;
Кажется, метод searchBarCancelButtonClicked
хорошо работать с этим параметром YES
, который является настройкой по умолчанию.