Safari网页视频全屏失效需分五步排查：①关闭屏幕旋转锁定；②video标签必须同时含playsinline和webkit-playsinline属性；③requestFullscreen()须在用户手势（如click）中调用；④启用网站全屏权限并清除MediaCache缓存；⑤禁用广告拦截扩展并重置video控件状态。
当你在Safari浏览器中播放网页视频，拖动进度条毫无反应、点击全屏按钮无任何变化，甚至横屏后画面仍卡在窄幅状态，问题大概率出在iOS/macOS系统级限制、网页代码缺失关键属性或浏览器权限被静默拦截——这些故障点互不重叠，需分路径逐一验证。
检查并关闭设备屏幕旋转锁定
这是全屏失效最常被忽略的物理前提。iPad和iPhone上，Safari视频全屏强依赖横屏手势；一旦系统级旋转锁定开启，页面根本不会响应横屏，全屏按钮也不会出现。
从屏幕右上角向下滑动打开控制中心。
找到带锁形图标的“屏幕旋转锁定”按钮，若呈高亮状态，点击一次关闭。
将设备横向握持，等待页面自动适配——多数主流视频站（B站、腾讯视频）会在0.5秒内触发全屏渲染。
确认video标签是否同时声明playsinline和webkit-playsinline
iOS Safari对<video>标签的全屏能力有硬性要求：必须同时存在playsinline和webkit-playsinline两个属性，且必须在HTML源码中静态写入，不能靠JavaScript动态添加。
方法一：直接修改HTML源码，在<video>标签内补全这两个属性：<video controls playsinline webkit-playsinline src="video.mp4"></video>
方法二：若使用Vue/React等框架，确保该属性在组件首次渲染时就存在于DOM上——不要在mounted或useEffect里通过setAttribute追加，iOS Safari不会识别运行时注入的webkit-playsinline。
【必须同时写两个属性，漏掉webkit-前缀或拼错成playinline（少s）都会失效】
验证全屏调用是否发生在用户手势上下文中
Safari强制要求：所有requestFullscreen()调用必须发生在用户事件回调内（如click、touchend），否则静默失败，控制台不报错但毫无反应。
第一步：确认你的全屏按钮绑定的是原生事件，不是自定义事件或Promise回调。
第二步：检查JS代码是否形如以下安全写法：button.addEventListener('click', () => { videoEl.requestFullscreen(); });
第三步：避免在autoplay完成后的play事件里直接调用全屏——这不算有效用户手势，iOS会拒绝。
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
第四步：如果用了自定义控件，别再调用已废弃的webkitEnterFullscreen()，它在iOS 15+完全失效。
启用网站全屏权限并清除媒体缓存
浏览器可能对当前视频网站禁用了全屏API调用权限，尤其在用户曾手动拒绝过“允许全屏”提示后，该限制会持久保存。
1、在Safari中打开目标视频页面，点击地址栏左侧的锁形图标。
2、在弹出菜单中选择“网站设置”→向下滚动至“全屏”选项，将其设为“允许”。
3、关闭Safari，前往访达，按Command+Shift+G，输入：~/Library/Caches/com.apple.Safari/，删除其中所有以MediaCache开头的文件夹。
4、重启Safari，在地址栏输入：safari://debug，回车后勾选“强制禁用GPU进程”。
5、重新加载视频页面，测试全屏按钮是否恢复触发能力。
禁用广告拦截类扩展并重置媒体控件状态
第三方Safari扩展（如AdGuard、uBlock Origin）可能重写或屏蔽webkitEnterFullscreen等原生方法，导致控件无响应。
点击Safari菜单栏中的Safari → 偏好设置 → 扩展，逐个关闭已启用的扩展，每关闭一个即返回视频页测试全屏功能。
若某扩展关闭后恢复正常，可对该扩展的站点权限进行细化设置，或更换为兼容性更强的替代方案。
在视频播放状态下，右键点击视频区域（如支持），选择“检查元素”打开开发者工具。
切换到控制台标签页，粘贴并执行以下代码：document.querySelector('video').controls = false; document.querySelector('video').controls = true;
观察视频下方控件是否刷新，随后点击全屏按钮测试响应性。
