Swift跳转新视图控制器TableView不加载、API请求报错排查

问题现象汇总 #

• 在InitialViewController的tableView(_:didSelectRowAt:)代理方法中，通过导航控制器push已实例化的NewViewController，跳转后仅显示顶部导航栏与返回按钮，绑定的UITableView完全空白
• 全程无编译、运行报错，最初NewViewController内部编写的所有打印语句均未执行
• 修复生命周期问题后，页面生命周期方法可正常触发、打印语句正常输出，但调用YelpApi类通过async/await发起请求时，代码执行到JSONDecoder解码步骤即抛出错误进入catch块，列表因无有效数据源仍无法加载内容
• 断点确认网络请求可正常返回原始数据，错误仅发生在数据解码阶段

第一阶段问题：生命周期不触发导致页面空白 #

根因 #

NewViewController中错误将viewDidLoad生命周期方法声明为async类型，且移除了override关键字，UIKit无法正常识别并调用该生命周期方法，导致写在方法内的TableView cell注册、delegate与dataSource绑定逻辑完全未执行。

修复方式 #

将viewDidLoad改回UIKit标准实现格式，移除async标记：

override func viewDidLoad() {
    super.viewDidLoad()
    // 此处编写cell注册、代理绑定、初始请求逻辑
}

修复后即可验证生命周期方法正常执行，内部打印语句可正常输出。

第二阶段问题：Yelp API 数据解码失败 #

高概率根因 #

• Codable数据模型与接口实际返回结构不匹配：常见问题包括字段类型不一致、可选值标记错误、嵌套层级对应错误、字段名拼写和接口返回Key不匹配
• 解码器配置缺失：Yelp接口返回字段默认是蛇形命名（如image_url、review_count），如果未给JSONDecoder设置对应的键名转换策略，会直接导致字段映射失败
• 根结构解码错误：Yelp业务搜索接口的返回根结构是包含businesses数组的对象，并非直接返回商家数据数组，如果直接用[Venue].self作为解码目标类型会直接失败
• 请求参数拼接错误：参数未做URL编码、必填参数缺失会导致接口返回错误结构的响应（如错误提示对象），和预期的业务数据结构不匹配导致解码失败

排查&修复步骤 #

1. 不要只打印泛化的"请求失败"提示，catch块中直接打印完整的解码error对象，错误信息会明确指出解码失败的字段、层级位置，可直接定位问题
2. 给解码器配置蛇形命名转驼峰的策略：

let decoder = JSONDecoder()
decoder.keyDecodingStrategy = .convertFromSnakeCase
// 如果接口返回包含日期字段，需同步配置对应的dateDecodingStrategy

3. 将网络请求返回的原始Data转为JSON字符串打印，和自定义的Venue模型逐字段对比层级、类型、字段名，确保完全匹配
4. 确认解码的根类型正确：如果接口返回格式为{"businesses": [Venue], "total": xxx}，需要先定义对应根结构的Codable模型，取其中的businesses数组作为列表数据源，不要直接解码商家数组
5. 检查请求参数拼接逻辑，确保经纬度、查询词等参数做了合法的URL编码，必填参数无缺失，避免接口返回错误响应结构

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