WKWebView在iOS 17+中常因User-Agent被识别为Mac桌面端导致页面错乱，需通过customUserAgent强制设为含iPhone/iPad和Mobile的移动UA，并在首次load前完成设置，再清除缓存验证效果。
当你在iOS应用中用WKWebView加载网页，却发现页面显示成桌面版、按钮错位或功能失效，大概率是Safari WebView的User-Agent被服务器误判为Mac桌面端而非iPhone或iPad——这在iOS 17+系统中尤为常见，因为Safari会把iPad UA伪装成macOS格式。
确认当前WebView实际发送的UA字符串
第一步：在Xcode中运行App → 触发WebView加载目标URL → 在控制台捕获Network请求 → 展开任意一个HTML主文档请求 → 查看Request Headers里的User-Agent字段。
第二步：重点检查是否含Mac OS X但不含Mobile或iPad关键词。例如出现Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15...，就说明服务器正把它当桌面浏览器处理。
第三步：对比真实iOS Safari的UA（如iPhone）：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";
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
绕过UA依赖的前端兼容方案
如果后端无法配合修改，且你控制前端代码，可在网页JS中主动检测并修正viewport行为：
在HTML <head> 中插入：
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
再添加一段强制启用移动端渲染的脚本：
if (navigator.userAgent.includes("Mac OS X") && !navigator.userAgent.includes("Mobile")) { document.querySelector('meta[name="viewport"]').setAttribute("content", "width=375"); // 假设iPhone宽度 document.documentElement.style.fontSize = "16px";}
这一步能防止因UA缺失Mobile导致viewport被禁用，从而避免布局错乱。
验证修复效果
1. 清除App内所有WebView缓存：调用[[WKWebsiteDataStore defaultDataStore] removeDataOfTypes:modifiedSince:completionHandler:]，类型传@[WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache]；
2. 重启App，重新加载页面；
3. 再次抓包确认User-Agent已更新为含iPhone/iPad和Mobile的字符串；
4. 检查页面是否正常响应式布局、按钮可见、AJAX接口返回正确数据。
