如何在Swift中为MapBox iOS SDK及WMS服务瓦片请求添加自定义HTTP请求头？

我明白你在Swift环境下给MapBox iOS SDK配置自定义HTTP头时遇到的麻烦——直接修改MGLNetworkConfiguration.shared.sessionConfiguration.httpAdditionalHeaders确实经常不生效，尤其是针对WMS这类第三方瓦片服务的请求。之前看到的Objective-C方案在Swift里不能直接照搬，不过下面两种经过验证的Swift实现方式，应该能帮你搞定：

MapBox提供了requestModifier闭包作为请求拦截的官方入口，能确保所有由SDK发起的网络请求（包括WMS瓦片请求）都会经过你的修改，不会被内部逻辑覆盖。

你可以在App启动时（比如AppDelegate的didFinishLaunchingWithOptions或者SceneDelegate的willConnectTo方法中）配置这个拦截器：

import Mapbox

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 配置MapBox请求拦截器
    MGLNetworkConfiguration.shared.requestModifier = { originalRequest in
        var modifiedRequest = originalRequest
        
        // 添加通用自定义HTTP头
        modifiedRequest.setValue("Your-Custom-Value", forHTTPHeaderField: "X-Custom-Header")
        modifiedRequest.setValue("Bearer your-auth-token", forHTTPHeaderField: "Authorization")
        
        // 可选：仅针对WMS请求添加专属头
        if let requestURL = modifiedRequest.url, requestURL.absoluteString.contains("wms") {
            modifiedRequest.setValue("WMS-Specific-Value", forHTTPHeaderField: "X-WMS-Custom-Header")
        }
        
        return modifiedRequest
    }
    
    return true
}

为什么这个方法有效？ #

这个闭包会在MapBox发起每一个网络请求前被调用，你可以直接修改请求实例的任何属性，包括HTTP头。相比直接修改session配置，它是SDK明确支持的扩展点，兼容性和可靠性都更高。

如果你需要更精细的网络控制（比如自定义证书验证、代理设置等），可以替换MapBox的默认URLSession，同时结合requestModifier做双重保障：

import Mapbox

func setupCustomMapBoxNetworking() {
    // 创建自定义会话配置
    let customConfig = URLSessionConfiguration.default
    // 设置全局通用头（注意：部分请求可能被内部逻辑覆盖，所以建议搭配requestModifier）
    customConfig.httpAdditionalHeaders = [
        "X-Global-Custom-Header": "Global-Value",
        "Authorization": "Bearer your-auth-token"
    ]
    
    // 初始化自定义URLSession
    let customSession = URLSession(configuration: customConfig)
    
    // 替换MapBox的默认会话
    MGLNetworkConfiguration.shared.session = customSession
    
    // 再次添加requestModifier确保所有请求都能带上目标头
    MGLNetworkConfiguration.shared.requestModifier = { originalRequest in
        var modifiedRequest = originalRequest
        // 针对特定WMS服务补充头
        if modifiedRequest.url?.host == "your-wms-server-domain.com" {
            modifiedRequest.setValue("Target-WMS-Value", forHTTPHeaderField: "X-WMS-Server-Header")
        }
        return modifiedRequest
    }
}

MapBox的内部网络层会针对不同类型的请求（比如自有瓦片、第三方WMS服务）做特殊处理，可能会重新初始化会话或者覆盖默认的HTTP头配置。直接修改sessionConfiguration的头信息，无法确保被所有请求类型继承，这就是你之前尝试失败的原因。

• 务必在初始化MGLMapView之前完成这些配置，避免部分请求提前发出而未带上自定义头。
• 可以用Charles、Proxyman等抓包工具验证请求头是否正确添加，确保配置生效。
• 如果使用MapBox Studio自定义样式，WMS源的配置不需要额外修改，自定义头会通过上述代码自动添加到瓦片请求中。

内容的提问来源于stack exchange，提问作者tolga güler