Swift网络架构扩展：APIResource协议body属性访问值不一致问题

最可能的核心原因：协议属性与实现类属性类型不匹配 #

你遇到的问题典型是协议要求的body属性类型，和PostItemResource中实际定义的body属性类型不一致，导致了「协议层面访问body取到默认nil，但dump时能看到实例自身的同名属性值」的矛盾现象。

举个具体的错误场景例子：

• 你在APIResource协议中定义的是：

  protocol APIResource {
      var body: Data? { get }
  }
  

• 但在PostItemResource中，你为了方便用字典存请求体，定义了同名但不同类型的属性：

  struct PostItemResource: APIResource {
      var body: [String: Any]? // 类型与协议要求的Data?不匹配
  }
  

这种情况下，PostItemResource并没有真正实现协议要求的Data?类型的body属性，协议会自动使用扩展提供的默认nil值；而dump时会显示实例所有的属性，包括你自定义的[String: Any]?类型的body，就出现了「dump能看到值，但直接访问postData.body返回nil」的情况。

修复方案 #

根据你的需求，有两种常见的正确实现方式：

方案1：统一协议与实现类的属性类型为Data?

直接让PostItemResource的body属性符合协议的Data?要求，初始化时提前完成字典转Data的操作：

protocol APIResource {
    var body: Data? { get }
}

extension APIResource {
    var body: Data? { nil }
}

struct PostItemResource: APIResource {
    var body: Data?
    
    init(bodyDictionary: [String: Any]) throws {
        self.body = try JSONSerialization.data(withJSONObject: bodyDictionary)
    }
}

方案2：用关联类型支持可编码的请求体

如果希望直接用自定义结构体或字典作为请求体，可以给协议添加关联类型，同时扩展中处理编码逻辑：

protocol APIResource {
    associatedtype Body: Encodable
    var body: Body? { get }
}

extension APIResource {
    var body: Body? { nil }
    
    // 扩展中添加编码方法
    func encodedBody() throws -> Data? {
        guard let body = body else { return nil }
        return try JSONEncoder().encode(body)
    }
}

// 自定义请求体结构体（推荐，类型更安全）
struct ItemRequest: Encodable {
    let name: String
    let value: Int
}

struct PostItemResource: APIResource {
    typealias Body = ItemRequest
    var body: ItemRequest?
    
    init(name: String, value: Int) {
        self.body = ItemRequest(name: name, value: value)
    }
}

这种方式下，在upload函数中调用resource.encodedBody()即可拿到可发送的Data，同时保证类型安全。

额外检查点 #

1. 确认upload函数是泛型函数，接受T: APIResource类型的参数，避免协议类型擦除导致的属性访问问题：

   func upload<T: APIResource>(_ resource: T) async throws {
       guard let bodyData = try resource.encodedBody() else {
           throw NetworkError.invalidInput
       }
       // 后续URLSession请求逻辑
   }
   

2. 检查PostItemResource中的body属性访问级别，确保是internal或更高（默认就是），否则无法满足协议的属性要求。

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