最常见的play()报错是DOMException: The element has no supported sources，因未加载有效音视频资源就调用；其次为Promise拒绝，因缺少用户手势触发；还有安卓WebView静默失败及Web Audio混用导致的音频异常。
play() 报错：DOMException: The element has no supported sources
这是最常见的 play() 报错，浏览器根本没加载到任何可用音视频资源就调了播放。
典型场景：HTML 里写了 <video></video> 标签但没设 src，或者 src 是空字符串、404 路径、跨域未配 CORS 的地址；也可能是 JS 动态赋值后没等 loadedmetadata 就急着调 play()。
- 检查
video或audio元素的src属性是否真实存在且可访问（直接粘贴到浏览器地址栏试试） - 确保服务端对媒体文件返回了正确的
Content-Type（如video/mp4），否则 Chrome 会拒绝解码 - 动态设置
src后，用element.addEventListener('loadedmetadata', () => element.play())替代立即play() - 避免在
DOMContentLoaded阶段就调play()，此时资源很可能还没开始加载
play() 返回 Promise 拒绝：Uncaught (in promise) DOMException: play() failed because the user didn't interact with the document first
现代浏览器强制要求音视频自动播放必须由用户手势触发（比如 click、touchstart），否则 play() 返回的 Promise 会被拒绝。
这个错误不会抛出同步异常，所以 try/catch 捕获不到，必须用 .catch() 处理。
- 把
play()调用严格绑定在用户事件回调里，例如button.addEventListener('click', () => video.play()) - 不要在
setTimeout、scroll、mousemove等非交互事件里调用play() - 如果想“预加载+静音自动播”，先设
video.muted = true和video.autoplay = true，再在用户点击后取消静音 - 注意 iOS Safari 对
muted的判定更严格：必须在play()前已设为true，且不能是 JS 异步设的（比如在loadeddata里设完再play()可能失效）
play() 在某些安卓 WebView 或旧版 iOS 上完全不响应
不是报错，而是静默失败——Promise 既不 resolve 也不 reject，paused 仍为 true，readyState 卡在 0 或 1。
常见于 Cordova、Capacitor、微信内置浏览器或 Android 低版本 WebView，本质是媒体栈初始化不完整或策略拦截。
- 优先检测
video.readyState >= 2（HAVE_FUTURE_DATA）再调play()，而不是只看canplay事件 - 某些安卓 WebView 要求显式调用
load()：设完src后立刻video.load()，再监听canplay - 微信 iOS 客户端需在
WeixinJSBridgeReady后才允许操作媒体元素，否则可能被挂起 - 避免在
display: none或visibility: hidden的容器里调play()，部分 WebView 会跳过渲染管线导致无法播放
audioContext.resume() 和 play() 混用导致音频卡顿或无声
Web Audio API 和 HTMLMediaElement 混用时，play() 失败常是因为音频上下文处于 suspended 状态，尤其在页面恢复可见或从后台切回时。
这不是 play() 自身的问题，但错误现象高度相似：点击无反应、Promise 拒绝、或播放几帧后中断。
- 只要涉及 Web Audio（哪怕只是用
AudioContext创建一个OscillatorNode），就必须在用户交互中调一次audioContext.resume() - 不要依赖
play()自动唤醒 context；它只对 media element 生效，不联动 audioContext - 可以统一在首个 click/touch 事件里同时调
video.play()和audioContext.resume() - 监听
audioContext.state === 'suspended'并在需要时主动 resume，比等报错再处理更可靠
