SwiftUI iOS应用注册数据无法保存至后端API问题排查

核心结论：请求数据完整但解码报错，说明后端返回的响应结构与本地LoginOBJ模型不匹配，而非请求数据本身的问题，按以下步骤逐一排查：

1. 抓包确认后端实际响应结构 #

别只关注请求数据，必须获取后端返回的完整响应内容：

• 在AuthService的signup2方法中，添加响应打印代码：

  // 拿到响应data后先打印完整内容
  if let responseStr = String(data: data, encoding: .utf8) {
      print("注册接口响应: \(responseStr)")
  }
  

• 对比打印出的响应JSON，确认：
  • 是否存在data字段，且data内部是否有user键
  • 字段名大小写是否和本地模型一致（比如后端返回User而你模型里写的是user）

2. 检查LoginOBJ及关联模型的Codable实现 #

确保模型结构完全匹配后端响应：

• 确认LoginOBJ的data子结构体正确声明了user字段：

  struct LoginOBJ: Codable {
      let data: LoginData
      // 其他必填字段...
  }
  
  struct LoginData: Codable {
      let user: UserModel // 键名必须和后端返回完全一致
      // 其他必填字段...
  }
  

• 如果后端字段名和本地变量名不一致，必须手动指定编码键：

  struct LoginData: Codable {
      let userInfo: UserModel
  
      enum CodingKeys: String, CodingKey {
          case userInfo = "user" // 映射后端的"user"键到本地userInfo变量
      }
  }
  

• 检查UserModel本身的Codable实现，确认没有遗漏必填字段、字段类型不匹配的问题。

3. 优化解码错误的排查精度 #

在解码逻辑中添加更详细的错误输出，定位具体问题：

do {
    let loginResp = try JSONDecoder().decode(LoginOBJ.self, from: data)
    // 处理成功逻辑
} catch let decodeErr as DecodingError {
    switch decodeErr {
    case .keyNotFound(let missingKey, let context):
        print("缺失键: \(missingKey.stringValue)，路径: \(context.codingPath)")
    case .typeMismatch(let type, let context):
        print("类型不匹配: \(type)，路径: \(context.codingPath)")
    default:
        print("解码错误: \(decodeErr)")
    }
} catch {
    print("其他错误: \(error)")
}

通过codingPath可以明确知道是在哪个层级找不到user键（比如是LoginOBJ.data下缺失，还是data的子结构问题）。

4. 校验后端HTTP状态码 #

很多时候后端返回200但实际是注册失败的错误响应（比如邮箱已存在），此时响应结构和成功响应完全不同：

• 添加状态码判断逻辑：

  guard let httpResp = response as? HTTPURLResponse, (200...299).contains(httpResp.statusCode) else {
      // 处理非成功状态码的响应，打印错误内容
      if let errStr = String(data: data, encoding: .utf8) {
          print("注册失败响应: \(errStr)")
      }
      return
  }
  

• 若后端返回错误结构（比如{"error": "邮箱已注册"}），用LoginOBJ解码自然会找不到user键。

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