NSURLSession主线程代理不触发问题及同步等待方案咨询

首先得搞清楚你遇到的核心问题：

• 当把[NSOperationQueue mainQueue]传给delegateQueue时，主线程被同步等待逻辑（比如runUntilDate:）阻塞，导致主队列上的NSURLSession代理任务根本没机会被执行，所以代理方法完全不触发。
• 传nil时NSURLSession会创建自己的子线程队列，代理能正常执行，但不在主线程；而XCTestExpectation能正常工作是因为它的等待机制不会卡死主线程的RunLoop，主队列任务仍能被调度。

针对你“无需大幅修改现有同步等待代码”的需求，这里有两个实用方案：

方案一：代理在子线程触发，业务逻辑dispatch到主线程（改动最小） #

这个方案不需要修改你的同步等待逻辑，只需要在代理方法里把核心业务逻辑转到主线程执行即可，完美兼容现有代码：

1. 初始化NSURLSession时传nil，让它用默认的子线程队列：

NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:nil];

2. 在所有代理方法中，把业务逻辑dispatch到主线程：

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data {
    // 把需要在主线程执行的逻辑包起来
    dispatch_async(dispatch_get_main_queue(), ^{
        // 你的原有业务代码，现在在主线程运行
        [self processReceivedData:data];
    });
}

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error {
    dispatch_async(dispatch_get_main_queue(), ^{
        // 完成逻辑也转到主线程
        [self handleTaskCompletion:error];
        // 触发同步等待的信号量/标记
        dispatch_semaphore_signal(self.semaphore);
    });
}

3. 保留你原有的同步等待逻辑（比如信号量或runUntilDate:）即可，因为子线程的代理能正常触发，不会被主线程的等待阻塞。

方案二：让代理直接在主线程执行，修改同步等待逻辑（适合必须代理全在主线程的场景） #

如果你要求代理方法本身必须在主线程执行，那不能用runUntilDate:卡死主线程RunLoop，需要换成能让RunLoop持续处理事件的循环：

1. 初始化NSURLSession时用主队列：

NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];

2. 把原有的runUntilDate:同步等待改成RunLoop循环，让主线程定期处理事件：

__block BOOL taskFinished = NO;

NSURLSessionDataTask *task = [session dataTaskWithRequest:yourRequest];
[task resume];

// 循环让RunLoop处理事件，直到任务完成
while (!taskFinished) {
    // 每次让RunLoop运行0.1秒，处理队列中的任务（包括NSURLSession的代理任务）
    CFRunLoopRunInMode(kCFRunLoopDefaultMode, 0.1, YES);
}

3. 在完成代理方法中标记任务结束：

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error {
    // 标记任务完成，退出循环
    taskFinished = YES;
    // 你的主线程业务逻辑
}

这个方案只需要修改同步等待的部分，代理方法不需要额外改动，能保证代理全程在主线程执行。

关键原理补充 #

• 主队列的任务依赖主线程RunLoop调度，一旦主线程被runUntilDate:这类方法阻塞，RunLoop无法处理队列中的新任务，NSURLSession的代理自然不会触发。
• CFRunLoopRunInMode可以让RunLoop在指定模式下运行一段时间，期间会处理所有待执行的队列任务，所以能让主队列上的代理方法得到执行。

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