Safari浏览器如何修复在Webview中运行时的User Agent识别错误？

WKWebView 在 iOS 17+ 上经常闹脾气——明明跑在 iPhone 或 iPad 上，User-Agent 却被 Safari 偷偷换成了 Mac 桌面版的格式。结果呢？页面按钮错位、布局乱套、功能失效，服务器死活不认你是移动设备。这个问题在 iOS 17 系统中尤为突出，因为苹果把 iPad 的 UA 伪装成了 macOS 格式，导致前端判断全面翻车。

所以，如果你在 App 里用 WKWebView 加载网页，发现显示的是桌面版、按钮点了没反应，十有八九就是 User-Agent 在捣鬼——它被误判成了 Mac 桌面端。别急，咱们一步步解决。

确认当前 WebView 实际发送的 UA 字符串

先搞清楚 WebView 到底在发什么 UA。在 Xcode 里跑 App，触发 WebView 加载目标网页，然后打开控制台抓包。找到任意一个 HTML 主文档请求，展开 Request Headers，盯着 User-Agent 字段看。

关键点：如果 UA 里出现了 Mac OS X，却没有 Mobile 或 iPad 这类词，比如这样：Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15... —— 恭喜，服务器正把它当台式机处理。拿真实 iPhone 的 UA 对比一下就明白了：Mozilla/5.0 (iPhone; CPU iPhone OS 17_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1。差别在哪？一个是 iPhone 或 iPad 设备标识，加上 Mobile 标记，缺一不可。

强制 WebView 使用标准 iOS 移动 UA

方法一：直接在 WKWebView 初始化后覆盖 UA（最推荐的做法）。

创建完 WKWebView 实例后、调用 loadRequest: 之前，执行这句：

webView.customUserAgent = @"Mozilla/5.0 (iPhone; CPU iPhone OS 17_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1";

这里有个坑：必须在首次 load 之前设置，否则写了也白写。iOS 系统会缓存第一次加载时的 UA，后续再改根本不认账。

方法二：通过 WKWebViewConfiguration 统一配置（适用于多个 WebView 共用同一套设置）。

创建配置对象时直接注入：

WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
config.applicationNameForUserAgent = @"YourApp/1.0";
WKWebView *webView = [[WKWebView alloc] initWithFrame:CGRectZero configuration:config];
webView.customUserAgent = @"Mozilla/5.0 (iPad; CPU OS 17_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1";

注意：如果你用的是 iPad，别忘了把 UA 里的 iPhone 换成 iPad。

绕过 UA 依赖的前端兼容方案

如果后端实在改不了，或者你正好能控制前端代码，那就直接在 HTML 里动手脚。在 里加一个 viewport meta 标签：

再补上一段强制移动端渲染的 Ja vaScript 脚本：

if (na vigator.userAgent.includes("Mac OS X") && !na vigator.userAgent.includes("Mobile")) {
document.querySelector('meta[name="viewport"]').setAttribute("content", "width=375"); // 假设 iPhone 宽度
document.documentElement.style.fontSize = "16px";
}

这小段代码的作用就是：当 UA 里出现 Mac OS X 但没有 Mobile 时，强行把 viewport 设成 iPhone 宽度（375px），防止因 UA 缺失移动标识导致 viewport 被禁用，从而避免布局彻底崩掉。

验证修复效果

1. 清除 App 里所有 WebView 缓存。调用 [[WKWebsiteDataStore defaultDataStore] removeDataOfTypes:modifiedSince:completionHandler:]，类型传 @[WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache]；

2. 重启 App，重新加载页面；

3. 再次抓包，确认 User-Agent 已经更新成包含 iPhone/iPad 和 Mobile 的字符串；

4. 检查页面响应式布局是否正常、按钮是否可见、AJAX 接口返回数据是否正确。