Swift使用Combine DataPublisher时API请求Headers设置无效问题

问题概述 #

从URLSession.dataTask迁移到Combine的dataTaskPublisher后，API请求返回401未授权错误，控制台仅输出响应头，看不到自定义设置的Authorization、Content-Type等请求头。尝试用addValue替代setValue设置请求头，问题依旧。

排查步骤与解决方案 #

1. 确认请求头是否正确构建 #

在调用dataTaskPublisher之前，直接打印请求的所有头信息，验证构建逻辑：

// 在URLSession.shared.dataTaskPublisher(for: request)前添加
print("Request Headers: \(request.allHTTPHeaderFields ?? [:])")

• 如果输出里没有目标请求头，说明是请求构建阶段出错；
• 如果有目标请求头，问题则出在网络传输或后端验证逻辑。

2. 检查Token格式与有效性 #

• 严格核对Authorization头格式：必须是"Bearer 你的Token"，注意Bearer后面有一个空格，避免拼写错误（比如误写为Berear）；
• 用Postman/Insomnia直接调用API，使用相同Token验证。如果工具调用也返回401，说明Token过期、无效或权限不足，与Combine无关。

3. 抓包验证实际发送的请求头 #

控制台仅能看到响应头，无法确认请求头是否真的发送到服务器。用Charles、Proxyman或Xcode Network Inspector抓包：

• 若抓包显示请求头缺失，说明URLSession配置可能拦截了请求头；
• 若请求头存在但仍返回401，联系后端排查Token验证逻辑。

4. 排查URLSession配置问题 #

默认URLSession.shared可能受全局配置影响，尝试创建自定义URLSession：

let config = URLSessionConfiguration.default
// 可在此全局配置通用请求头
config.httpAdditionalHeaders = [
    "Content-Type": "application/vnd.api+json",
    "Accept": "application/vnd.api+json"
]
let customSession = URLSession(configuration: config)

// 使用自定义Session发起请求
customSession.dataTaskPublisher(for: request)
    // ... 后续Combine链式逻辑

5. 优化错误处理，获取后端细节 #

当前代码在tryMap中仅判断200状态码，可解析401响应数据获取后端具体错误提示：

.tryMap { (data, response) -> Data in
    guard let httpResponse = response as? HTTPURLResponse else {
        throw URLError(.badServerResponse)
    }
    if httpResponse.statusCode == 401 {
        if let errorDetail = String(data: data, encoding: .utf8) {
            print("401 Error Detail: \(errorDetail)")
        }
        throw URLError(.userAuthenticationRequired)
    } else if httpResponse.statusCode != 200 {
        throw URLError(.badServerResponse)
    }
    return data
}

常见坑点 #

• 拼写错误：Authorization头的Bearer拼写错误，或Token前后存在多余空格/换行；
• GET请求的Content-Type：部分服务器会忽略GET请求的Content-Type头，但Authorization头必须存在；
• URLSession缓存：旧请求缓存可能复用错误配置，可禁用缓存：

  config.requestCachePolicy = .reloadIgnoringLocalCacheData
  

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