如何更新WKWebView应用使其兼容更低版本iOS系统

首先把项目的最低部署版本改成你计划兼容的目标版本（建议最低到iOS12即可，再低的系统市场占比极低，适配投入产出比很差），改完Xcode会自动标记所有不兼容低版本的API，按以下规则逐个处理即可：

1. 替换/兼容iOS 15+专属WKWebView API #

所有iOS15才新增的WKWebView相关API，必须加版本判断，低版本走兼容逻辑，常见的高频API包括：

• underPageBackgroundColor：iOS15+才支持的页面底层背景色属性，低版本可以通过关闭webView透明度、手动设置webView和scrollView背景色实现同样效果
• callAsyncJavaScript、async/await版本的evaluateJavaScript方法：低版本没有对应实现，要改回传统的completionHandler回调形式的JS执行方法
• findInteraction：iOS15+才内置的文本查找交互，低版本要自己注入JS实现文本查找能力，或者直接隐藏查找入口
• WKWebView相关的所有Lockdown Mode、CMP权限相关API：低版本直接跳过对应逻辑即可

版本判断写法参考：

if #available(iOS 15.0, *) {
    webView.underPageBackgroundColor = .systemBackground
} else {
    webView.isOpaque = false
    webView.backgroundColor = .systemBackground
    webView.scrollView.backgroundColor = .systemBackground
}

2. 修正WKWebView通用行为的低版本兼容逻辑 #

这部分是最容易踩坑的，API兼容只是表面，行为差异才是低版本闪退、白屏的主要原因：

• JS桥接逻辑：iOS14及以下用WKScriptMessageHandler注册桥接方法时，必须在页面退出时主动调用removeScriptMessageHandler(forName:)移除注册，否则不仅会循环引用泄漏内存，在iOS12/13系统上还会偶现桥接消息丢失、应用闪退的问题
• 页面加载容错：低版本WKWebView的内容进程在内存不足时被系统杀掉的概率远高于iOS15，必须实现webViewWebContentProcessDidTerminate(_:)代理方法，进程终止后主动重新加载页面，避免永久白屏；另外低版本estimatedProgress在重定向场景可能出现值大于1.0的情况，KVO监听进度时要做>=1.0的容错，避免进度条卡住不消失
• Cookie同步逻辑：iOS14及以下WKHTTPCookieStore的Cookie写入时序和iOS15不一致，不要写完Cookie立刻做页面跳转，必须等setCookie(_:completionHandler:)的回调执行完再走后续逻辑，否则低版本会出现Cookie丢失、登录态失效的问题
• 弹窗逻辑：iOS14及以下如果在页面未完全加载时触发JS的alert/confirm/prompt，大概率会出现弹窗不弹出、主线程卡死的问题，要在WKUIDelegate对应的弹窗代理方法里加判断，如果当前webView不在可见层级，先缓存弹窗内容，等页面处于活跃状态后再弹出
• 权限逻辑：iOS14及以下WKWebView不会自动透传web侧触发的相机、麦克风、定位权限申请，必须自己拦截对应JS请求，原生端主动申请系统权限后，再通过JS回调把权限状态回传给web端，否则低版本上web侧的权限功能会直接失效

3. 前端资源适配 #

如果你的应用加载的是线上/内置的前端页面，还要同步调整前端逻辑：

• 前端JS代码如果用了ES2022+语法、top-level await、FileSystem API、WebRTC新特性这类iOS15才完整支持的web能力，要加babel做语法降级，对应功能在低版本做兜底提示，不要直接让页面报错白屏
• 本地加载HTML资源时，低版本WKWebView的跨域限制比iOS15严格，调用loadFileURL(_:allowingReadAccessTo:)时要准确设置允许读取的目录范围，不要依赖iOS15的宽松跨域策略，否则本地资源加载会直接失败

4. 测试注意事项 #

不要只在低版本模拟器上测试，WKWebView在模拟器和真机上的低版本行为差异极大，尤其是输入框聚焦、音视频自动播放、滚动回弹、桥接调用这几个场景，模拟器基本测不出真实问题，必须找对应系统版本的真机跑全核心流程。

内容的提问来源于stack exchange，提问作者Alex Phạm