Swift 5环境下iPhone端VPN连接等待时无法显示提示文本的问题排查

你的核心问题在于主线程被阻塞，导致UI更新无法及时生效，具体原因和修复方案如下：

为什么你的提示文本看不到？ #

在viewDidLoad中，你执行了以下流程：

1. 创建并添加testlabel到WebView
2. 调用CheckVPNConnetionLoop()——这个耗时函数会同步阻塞主线程
3. 立刻移除testlabel并加载网页

iOS的UI绘制依赖主线程的RunLoop处理，当主线程被CheckVPNConnetionLoop()阻塞时，系统根本没有机会执行testlabel的绘制渲染操作。等耗时函数执行完，你又马上把label移除了，所以设备上完全看不到提示内容。

模拟器性能通常比真机好，耗时操作可能瞬间完成，所以才会出现和设备不一致的表现。

修复方案：异步处理耗时任务，避免阻塞主线程 #

你需要把VPN检查放到后台线程执行，同时在主线程控制UI的显示和隐藏。具体修改如下：

1. 调整代码结构，使用异步任务 #

首先把testlabel改为实例变量，方便在后台任务完成后访问：

@IBOutlet var mWebKit: WKWebView!
let myURL = URL(string: "https://theurl.com") // 注意补全URL的协议头
var testLabel: UILabel!

override func viewDidLoad() {
    super.viewDidLoad()
    mWebKit.navigationDelegate = self
    
    // 初始化并添加提示文本
    setupLoadingLabel()
    
    // 后台执行VPN检查，不阻塞主线程
    DispatchQueue.global(qos: .background).async { [weak self] in
        guard let self = self else { return }
        self.CheckVPNConnetionLoop() // 耗时操作在后台执行
        
        // 任务完成后回到主线程更新UI
        DispatchQueue.main.async {
            self.testLabel.removeFromSuperview()
            if let url = self.myURL {
                let request = URLRequest(url: url)
                self.mWebKit.load(request)
            }
        }
    }
}

private func setupLoadingLabel() {
    testLabel = UILabel()
    testLabel.textAlignment = .center
    testLabel.font = UIFont(name: "Helvetica-Bold", size: 32)
    testLabel.textColor = .red
    testLabel.text = "正在检查VPN连接..."
    
    // 使用AutoLayout布局，适配不同屏幕和旋转场景
    testLabel.translatesAutoresizingMaskIntoConstraints = false
    mWebKit.addSubview(testLabel)
    
    NSLayoutConstraint.activate([
        testLabel.centerXAnchor.constraint(equalTo: mWebKit.centerXAnchor),
        testLabel.centerYAnchor.constraint(equalTo: mWebKit.centerYAnchor),
        testLabel.widthAnchor.constraint(equalTo: mWebKit.widthAnchor),
        testLabel.heightAnchor.constraint(equalTo: mWebKit.heightAnchor)
    ])
}

2. 额外优化建议 #

• 用UIActivityIndicatorView替代静态文本：更符合iOS加载状态的交互规范，用户体验更好
• 确保CheckVPNConnetionLoop()内部没有主线程操作：如果函数里有UI相关的代码，要移到主线程执行
• 添加超时处理：如果VPN检查长时间未完成，可以给用户提示或终止检查

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