必须由用户手势(如点击)触发 navigator.mediaDevices.getUserMedia(),否则 chrome 会因安全策略拒绝调用并报 NotAllowedError;需 httpS(或 localhost)、正确绑定 video.srcObject、检查设备可用性并前置权限判断。

调用 navigator.mediaDevices.getUserMedia() 时页面无反应或报错
多数情况下不是代码写错了,而是浏览器策略阻止了未安全上下文(non-secure context)下的摄像头访问。HTTP 页面直接调用 getUserMedia() 会静默失败或抛出 NotAllowedError 或 SecurityError。
- 必须使用 https 协议(本地开发可用
localhost,它被浏览器视为安全上下文) - 不能在 iframe 中调用,除非该 iframe 显式声明
allow="camera" - 不能在页面加载完成前就调用;确保 dom 就绪且用户有交互触发(如点击按钮),否则 Chrome 会拒绝自动启动媒体设备
document.getElementById('startBtn').addEventListener('click', async () => { try { const stream = await navigator.mediaDevices.getUserMedia({ video: true }); document.getElementById('video').srcObject = stream; } catch (err) { console.error('摄像头访问失败:', err.name); // 常见:NotAllowedError、NotFoundError、SecurityError } });
Chrome 报错 NotAllowedError: Permission denied
这不是权限没点“允许”,而是调用时机不合法。Chrome 要求媒体请求必须由用户手势(click、tap、keydown 等)直接触发,不能包裹在 setTimeout、promise.then 或事件委托链过深的回调里。
- 避免在
DOMContentLoaded或load事件中自动调用 - 避免通过
async/await链间接触发(比如先 await 一个 API,再调用getUserMedia) - 检查是否被广告拦截插件或企业策略屏蔽(部分公司内网策略会禁用
mediaDevicesAPI)
拿到流但 不显示画面
常见原因是未正确绑定流对象,或视频元素未设置 autoplay 和 muted(尤其在移动端 safari 和新版 Chrome 中,有声音的自动播放会被阻止,进而影响视频流渲染)。
-
是移动端必需属性组合 - 务必使用
video.srcObject = stream,而不是video.src = URL.createObjectURL(stream)(后者已废弃且内存泄漏风险高) - 确保
stream确实包含视频轨道:stream.getVideoTracks().length > 0
如何优雅降级或判断摄像头是否可用
不能只靠 try/catch,需前置检测环境支持与设备存在性。有些设备(如某些 windows 笔记本)摄像头硬件存在但驱动未启用,getUserMedia 仍会失败。
立即学习“前端免费学习笔记(深入)”;
- 先检查 API 是否存在:
if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) - 再枚举设备确认有视频输入:
await navigator.mediaDevices.enumerateDevices(),找kind === 'videoinput' - 注意:
enumerateDevices()也需要用户授权后才返回真实设备列表,首次调用仍需用户交互触发
async function checkCameraAvailable() { if (!navigator.mediaDevices?.enumerateDevices) return false; try { const devices = await navigator.mediaDevices.enumerateDevices(); return devices.some(d => d.kind === 'videoinput'); } catch (e) { return false; // 权限未授或策略拦截 } }
实际项目中最容易被忽略的是「用户交互触发」这一硬性要求——哪怕逻辑完全正确,只要不是由一次明确的点击发起,Chrome 就会拒之门外。别试图绕过,这是强制设计。