NSURLSession动态修改timeoutIntervalForResource无效问题求助

为什么修改已创建Session的Configuration不生效？ #

NSURLSession一旦创建，它的configuration是不可变的——你通过self.session.configuration拿到的只是原配置的副本，修改这个副本的参数不会对已存在的Session或后续创建的Task产生任何影响。

解决方案 #

根据你的Session类型（普通/后台）和系统版本，有几种可行的实现方式：

1. 预创建多个不同超时配置的Session（兼容所有iOS版本） #

这是最通用的方案，不管是后台Session还是普通Session都适用：

• 提前为不同的超时需求创建对应的Session实例
• 发起请求时根据API需求选择对应的Session

// 声明两个Session属性
@property (nonatomic, strong) NSURLSession *shortTimeoutSession;
@property (nonatomic, strong) NSURLSession *longTimeoutSession;

// 初始化时创建Session
- (void)setupSessions {
    // 短超时配置（8秒资源超时）
    NSURLSessionConfiguration *shortConfig = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"com.xxx.short-timeout"];
    shortConfig.timeoutIntervalForResource = 8.0f;
    shortConfig.timeoutIntervalForRequest = 20.0f;
    self.shortTimeoutSession = [NSURLSession sessionWithConfiguration:shortConfig delegate:self delegateQueue:nil];
    
    // 长超时配置（30秒资源超时）
    NSURLSessionConfiguration *longConfig = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"com.xxx.long-timeout"];
    longConfig.timeoutIntervalForResource = 30.0f;
    longConfig.timeoutIntervalForRequest = 20.0f;
    self.longTimeoutSession = [NSURLSession sessionWithConfiguration:longConfig delegate:self delegateQueue:nil];
}

// 发起请求时选择对应Session
- (void)sendTargetRequest:(NSURL *)url needsShortTimeout:(BOOL)needsShort {
    NSURLSessionDataTask *task;
    if (needsShort) {
        task = [self.shortTimeoutSession dataTaskWithURL:url];
    } else {
        task = [self.longTimeoutSession dataTaskWithURL:url];
    }
    [task resume];
}

2. 为单个NSURLRequest设置超时（仅适用于普通Session，iOS 13前） #

如果使用的是非后台Session（比如defaultSessionConfiguration或ephemeralSessionConfiguration），可以直接在创建请求时设置timeoutInterval，这个值的优先级高于Session配置的timeoutIntervalForRequest：

// 初始化一个通用Session
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
config.timeoutIntervalForRequest = 20.0f; // 默认单次请求超时
self.session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];

// 发送请求时动态设置超时
- (void)sendTargetRequest:(NSURL *)url needsShortTimeout:(BOOL)needsShort {
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    // 这里的timeoutInterval对应单次请求的超时（即timeoutIntervalForRequest）
    request.timeoutInterval = needsShort ? 8.0f : 30.0f;
    
    NSURLSessionDataTask *task = [self.session dataTaskWithRequest:request];
    [task resume];
}

注意：后台Session会忽略NSURLRequest的timeoutInterval设置，所以这种方法不适用于后台Session场景。

3. 直接修改Task的超时参数（iOS 13及以上） #

iOS 13之后，NSURLSessionTask新增了timeoutIntervalForResource和timeoutIntervalForRequest属性，可以在创建Task后直接修改，无需创建多个Session：

// 初始化一个通用Session
NSURLSessionConfiguration *config = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"com.xxx.common"];
self.session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];

// 发送请求时动态调整Task超时
- (void)sendTargetRequest:(NSURL *)url needsShortTimeout:(BOOL)needsShort {
    NSURLSessionDataTask *task = [self.session dataTaskWithURL:url];
    if (@available(iOS 13.0, *)) {
        // 动态设置资源总超时
        task.timeoutIntervalForResource = needsShort ? 8.0f : 30.0f;
        // 也可以单独设置单次请求超时
        // task.timeoutIntervalForRequest = 20.0f;
    }
    [task resume];
}

总结 #

• 后台Session场景：优先用预创建多Session的方案，iOS 13+也可以用修改Task属性的方式
• 普通Session场景：iOS 13前用请求级超时设置，iOS 13+直接修改Task属性更灵活

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