iOS WebView中HTML5页面无法滚动的主因是CSS高度设置（如height:100%）、-webkit-overflow-scrolling作用域错误及touchmove事件被preventDefault()拦截，需分别替换为min-height:100vh、作用于实际滚动容器、条件化阻止默认行为。
iOS WebView 中 HTML5 页面无法滚动，基本是 -webkit-overflow-scrolling、body 高度控制或事件拦截导致的，不是 bug，而是 iOS WebKit 的渲染机制限制。
检查 html 和 body 是否被设为 height: 100%
iOS Safari / WKWebView 对 height: 100% 的处理很严格：如果 html 或 body 显式设置了 height: 100%（尤其在 Vue/React 单页应用中常见），会导致内容高度无法撑开，从而滚动失效。
- 删掉所有类似
html, body { height: 100%; }的 CSS 规则 - 改用
min-height: 100vh替代，确保容器能随内容自然伸展 - 检查框架初始化时是否注入了全局样式（如某些 UI 库的 reset.css）
启用 -webkit-overflow-scrolling: touch 并确认作用域
该属性必须加在**实际有滚动内容且设置了固定高度或 max-height 的容器上**，不是加在 body 就能生效。
- 不要写：
body { -webkit-overflow-scrolling: touch; }（无效） - 要写：
.scroll-container { height: 300px; overflow-y: auto; -webkit-overflow-scrolling: touch; } - 注意：该属性只在 iOS 5–12 有效，iOS 13+ 已默认启用惯性滚动，但去掉它反而可能让老版本白屏
排查 touchmove 事件被 preventDefault() 拦截
JS 中监听了 touchstart 或 touchmove 并调用了 event.preventDefault()，会直接禁用原生滚动——这是最隐蔽也最常见的原因。
立即学习“前端免费学习笔记（深入）”；
- 搜索项目中所有
touchmove监听器，尤其是轮播图、手势拖拽、下拉刷新组件 - 避免无条件调用
preventDefault()；如需局部拦截，先判断是否在可滚动区域外：if (!e.target.closest('.scrollable')) e.preventDefault(); - 使用
{ passive: false }注册监听器时要格外小心，iOS 会默认将passive: true，强行设为false又没配preventDefault可能触发警告甚至阻断滚动
WKWebView 启动参数与 viewport 设置
原生侧未正确配置 WKWebView 或 HTML 的 viewport，也会导致视口错乱、缩放异常进而影响滚动感知。
- 确保 HTML 中有正确 viewport：
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">—— 注意user-scalable=no会禁用双指缩放，但不会禁滚动；若误写成height=device-height则大概率出问题 - iOS 原生侧：检查是否设置了
scrollView.bounces = NO或scrollView.scrollEnabled = NO（极少但存在） - 调试技巧：在 Safari 开发者工具中连上真机，选中
body查看 computed height，若显示0px或远小于内容高度，说明布局已断裂
滚动失效往往不是单一原因，而是 CSS 高度约束、JS 事件拦截、WebView 配置三者叠加的结果。优先查 body 高度和 touchmove 拦截，这两个点覆盖了 80% 以上的现场。
