Alamofire 5.1自定义Session配置未在请求中生效问题咨询

算力阿峰

2026-10-6

问题根因

Alamofire 5.x版本中URLSessionConfiguration.af.default是对系统默认配置的封装，你仅修改了单次请求传输的超时参数timeoutIntervalForRequest，未修改整个资源请求的总超时参数timeoutIntervalForResource，如果你的观测工具抓取的是总超时参数，就会看到默认60秒的配置；同时缓存配置未生效大概率是请求构造逻辑覆盖了全局配置。
自定义Session实例没有被全局持有：如果你的apiManager是声明在方法内部的局部变量，请求发起后实例会被ARC自动释放，后续请求流程会 fallback 到Alamofire默认Session，导致自定义配置失效。
请求构造逻辑覆盖配置：如果generateHeaders方法、自定义参数编码逻辑或附加的RequestInterceptor中，手动修改了生成的URLRequest的timeoutInterval、cachePolicy属性，会直接覆盖Session层面的全局配置。

解决方案

1. 调整Session配置并全局持有：将apiManager声明为全局变量或类的单例属性，同时补全总超时参数配置，示例如下：

// 全局持有，不要放在方法内部声明为局部变量
static let sharedApiManager: Session = {
    let configuration = URLSessionConfiguration.af.default
    // 同时设置单次请求超时和资源总超时，按需调整
    configuration.timeoutIntervalForRequest = 20
    configuration.timeoutIntervalForResource = 20
    configuration.requestCachePolicy = .reloadIgnoringCacheData
    configuration.urlCache = nil
    let manager = Alamofire.Session(
        configuration: configuration,
        cachedResponseHandler: ResponseCacher(behavior: .doNotCache)
    )
    return manager
}()

1. 排查请求构造逻辑：检查generateHeaders方法、参数编码逻辑和自定义拦截器，确认没有手动修改URLRequest的超时和缓存属性，如需修改可以在拦截器中统一调整为目标值。
1. 校验实际请求配置：可以新增请求创建的回调，打印实际生成的请求参数确认配置是否生效，示例如下：

sharedApiManager.request(
    url,
    method: .post,
    parameters: requestBodyParameters,
    encoding: JSONEncoding.default,
    headers: generateHeaders(enableAuth: authorisation)
)
.validate(statusCode: 200..<300)
.onURLRequestCreation { request in
    // 打印实际请求的配置，确认是否符合预期
    print("超时时间：\(request.timeoutInterval)")
    print("缓存策略：\(request.cachePolicy)")
}
.responseJSON { response in
    print(response)
}

1. 若调整后配置仍未生效，可以清理Xcode构建缓存后重新运行，排除旧编译缓存导致的问题。

内容的提问来源于stack exchange，提问作者BILAL A RAHMAN