URLSession请求后跳转视图时UIButton标签消失问题排查

嘿，我碰到过类似的坑，大概率是异步请求的线程处理不当导致的UI渲染异常。咱们一步步拆解问题，给你靠谱的解决方案：

问题根源分析 #

你在CustomLaunchScreenVC的viewDidAppear里调用的loginWithSession包含URLSession异步请求，而网络请求的回调默认是在后台线程执行的。如果直接在这个回调里做视图跳转或者UI更新操作，就会打乱UIKit的渲染逻辑，出现按钮标签消失这类异常。另外，启动页的视图生命周期和异步请求的执行顺序冲突，也可能让目标页面的UI初始化不完整。

具体解决方案 #

1. 强制所有UI操作在主线程执行 #

不管是跳转视图还是更新按钮标签，必须把这些操作放到主线程队列里。修改loginWithSession的回调部分：

func loginWithSession(uid: String, session: String) {
    guard let url = URL(string: "你的会话校验接口地址") else { return }
    var request = URLRequest(url: url)
    // 配置请求头、参数等
    
    let task = URLSession.shared.dataTask(with: request) { [weak self] data, response, error in
        guard let self = self else { return }
        
        // 处理请求错误
        if let error = error {
            print("会话校验失败: \(error.localizedDescription)")
            DispatchQueue.main.async {
                self.navigateToLoginVC()
            }
            return
        }
        
        // 校验成功，跳转主页面
        DispatchQueue.main.async {
            self.navigateToMainVC()
        }
    }
    task.resume()
}

// 封装跳转逻辑，统一放在主线程处理
private func navigateToLoginVC() {
    let loginVC = LoginVC()
    navigationController?.pushViewController(loginVC, animated: true)
}

private func navigateToMainVC() {
    let mainVC = MainVC()
    navigationController?.pushViewController(mainVC, animated: true)
}

2. 优化启动页的加载状态 #

在checkIfSignedIn执行前，先给用户显示加载提示，避免看到空白或异常界面，同时确保启动页的视图完全渲染后再处理跳转：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    showLoadingIndicator() // 显示一个UIActivityIndicatorView或者自定义加载动画
    checkIfSignedIn()
}

func checkIfSignedIn() {
    let defaults = UserDefaults.standard
    if let uid = defaults.string(forKey: "uid"), let session = defaults.string(forKey: "session") {
        loginWithSession(uid: uid, session: session)
    } else {
        DispatchQueue.main.async {
            self.hideLoadingIndicator()
            self.navigateToLoginVC()
        }
    }
}

// 封装加载提示的显示和隐藏
private func showLoadingIndicator() {
    let indicator = UIActivityIndicatorView(style: .large)
    indicator.center = view.center
    indicator.startAnimating()
    view.addSubview(indicator)
    // 可以把indicator存为属性，方便后续隐藏
}

private func hideLoadingIndicator() {
    // 找到并移除加载提示视图
    view.subviews.first { $0 is UIActivityIndicatorView }?.removeFromSuperview()
}

3. 检查目标页面的UI初始化逻辑 #

确保MainVC里的UIButton标签是在正确的生命周期方法里设置的，并且没有被后续操作覆盖：

class MainVC: UIViewController {
    private let actionButton = UIButton(type: .system)
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
    }
    
    private func setupUI() {
        // 设置按钮标签
        actionButton.setTitle("首页操作", for: .normal)
        actionButton.titleLabel?.font = UIFont.systemFont(ofSize: 16)
        // 布局按钮
        actionButton.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(actionButton)
        NSLayoutConstraint.activate([
            actionButton.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            actionButton.centerYAnchor.constraint(equalTo: view.centerYAnchor)
        ])
    }
}

4. 避免竞态条件（可选） #

如果请求速度过快，可能和启动页的视图渲染冲突，可以给系统一点缓冲时间再执行请求：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    showLoadingIndicator()
    // 延迟0.1秒执行，确保启动页UI完全渲染
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
        self.checkIfSignedIn()
    }
}

总结 #

核心原则就是UIKit的所有操作必须在主线程执行，异步请求的回调一定要通过DispatchQueue.main.async来处理视图跳转和UI更新。同时优化启动页的加载状态，能提升用户体验，也能避免一些生命周期冲突导致的UI异常。

内容的提问来源于stack exchange，提问作者Kárpáti András