iOS Swift跳转ViewController时出现“仅主线程运行”错误求助

这个问题很典型——你踩了iOS开发里一个常见的线程坑：所有UI操作必须在主线程执行，而你的页面跳转代码恰好跑在了后台线程上。让我一步步帮你理清原因并修复：

错误根源分析 #

URLSession的dataTask(with:completionHandler:)回调是在后台线程执行的（这是系统默认的网络队列，用来避免阻塞主线程）。你原本以为把网络请求放在DispatchQueue.main.async里就能解决问题，但其实这只是让任务的启动在主线程，回调依然会回到后台线程。当你在completion回调里直接执行页面跳转（present(next, ...)）时，就触发了系统的线程检查，抛出"Only run on the main thread!"错误。

具体修复方案 #

我们需要把UI相关的操作（包括completion回调的调用）切回主线程，同时优化代码的安全性：

第一步：修正登录请求函数 #

移除多余的DispatchQueue.main.async包裹网络请求启动，转而在回调处理完数据后，用DispatchQueue.main.async调用completion：

func loginClosure(completion:@escaping (Bool) ->Void) {
    var check = 0
    guard let url = URL(string: ConnectionString + "login") else {
        DispatchQueue.main.async { completion(false) }
        return
    }
    
    if submitEmail == nil || submitPassword == nil {
        submitEmail = email.text
        submitPassword = password.text
    }
    
    guard let email = submitEmail, let password = submitPassword else {
        DispatchQueue.main.async { completion(false) }
        return
    }
    
    let session = URLSession.shared
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    let parameter = "Email=\(email)&password=\(password)"
    request.httpBody = parameter.data(using: .utf8)
    
    // 网络请求启动不需要在主线程，移除原来的DispatchQueue.main.async包裹
    session.dataTask(with: request) { [weak self] data, response, error in
        guard let self = self else { return }
        
        if let error = error {
            print("网络请求错误: \(error)")
            DispatchQueue.main.async { completion(false) }
            return
        }
        
        guard let data = data else {
            DispatchQueue.main.async { completion(false) }
            return
        }
        
        do {
            guard let parsedData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? [String:Any],
                  let streams = parsedData["Profile"] as? [AnyObject] else {
                DispatchQueue.main.async { completion(false) }
                return
            }
            
            for stream in streams {
                self.result = stream["result"] as? Bool ?? true
                
                if let id = stream["id"] as? Int {
                    self.defaults.setValue(id, forKey: "my_id")
                    MYID = id
                    // 切换到主线程通知登录成功
                    DispatchQueue.main.async { completion(true) }
                    return
                }
            }
            
            if check == 0 {
                DispatchQueue.main.async { completion(false) }
            }
        } catch let error as NSError {
            print("JSON解析错误: \(error)")
            DispatchQueue.main.async { completion(false) }
        }
    }.resume()
}

第二步：安全调用登录并跳转 #

调用登录函数时，加上弱引用避免循环引用，同时安全处理ViewController实例化：

loginClosure { [weak self] success in
    guard let self = self else { return }
    
    if success {
        // 避免强制解包，防止标识符错误导致崩溃
        guard let nextVC = self.storyboard?.instantiateViewController(withIdentifier: "AccountC") as? AccountC else {
            print("无法加载AccountC视图控制器，请检查storyboard标识符")
            return
        }
        self.present(nextVC, animated: true)
    } else {
        // 这里可以添加登录失败的提示，比如弹窗或label提示
        print("登录失败，请检查账号密码")
    }
}

额外注意事项 #

• 永远不要在后台线程操作UI：包括页面跳转、控件更新、弹窗等所有和界面相关的操作，都必须放在主线程。
• 避免强制解包：用guard let或if let替代as!、!，减少崩溃风险。
• 弱引用避免内存泄漏：在闭包中使用[weak self]，防止ViewController因为被闭包持有而无法释放。

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