Electron 摄像头打不开/锁死问题排查手册

Electron 摄像头打不开/锁死问题排查手册

适用场景：本 Electron 桌面端应用出现摄像头无法打开、反复报错、或关闭软件后 Windows 自带相机也无法使用的情况。

最后更新：2026-04-16

一、问题现象

1.1 用户侧表现

1. 点击"打开摄像头"按钮，提示"无法访问摄像头"。
2. 有时能打开，有时打不开，表现为间歇性失败。
3. 出现报错后，关闭 Electron 软件，Windows 自带的"相机"应用也打不开。
4. 注销 Windows 用户后，自带相机依然打不开，必须重启电脑才能恢复。

1.2 控制台/日志侧表现

• 错误类型多为：NotReadableError（设备被占用）、OverconstrainedError（约束不支持）。
• 本地electron-log和中控平台日志显示摄像头反复初始化失败。

二、排查过程（按时间线）