MediaRecorder 必须依赖 MediaStream 才能工作，报错通常源于流未获取、无效或传参错误；需校验流有效性、确保 HTTPS 环境、避免手动 stop 流、正确管理生命周期。
MediaRecorder 不支持媒体流？这说法本身就不成立——它必须依赖 MediaStream 才能工作。如果你遇到“不支持”的报错，实际是流没拿到、流无效、或传错了对象。
MediaRecorder 构造时报 TypeError: Failed to construct 'MediaRecorder': parameter 1 is not of type 'MediaStream'
这是最常见的一类错误，说明你根本没传入合法的 MediaStream 实例。
-
常见错误现象：
anything-to-html下载将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 直接
new MediaRecorder(null)或new MediaRecorder(undefined) - 忘记
awaitnavigator.mediaDevices.getUserMedia()，导致 stream 还是undefined - 在 HTTP 环境下调用（非
https://或<a href="https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344">https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344</a>），浏览器静默拒绝，返回Promise.reject()但未捕获 - 误把
HTMLAudioElement.srcObject当作流使用，却没检查它是否已赋值（srcObject初始为null）
- 直接
-
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
try/catch包裹getUserMedia调用，显式处理NotAllowedError、NotFoundError、SecurityError - 拿到 stream 后立刻做校验：
if (!stream || !stream.getAudioTracks().length) { /<em> 流无效 </em>/ } - 非 localhost 的开发环境务必走 HTTPS，否则权限请求直接失败
- 用
MediaRecorder.start() 报 InvalidStateError: The MediaRecorder is inactive
这说明流虽然构造成功了，但已被关闭、或轨道被停掉，MediaRecorder 失去输入源。
-
常见错误现象：
- 调用了
stream.getTracks().forEach(t => t.stop())后还试图用这个 stream 初始化或启动 recorder - 页面切后台时监听
visibilitychange错误地调用了stream.stop()（应只暂停MediaRecorder） - React/Vue 组件卸载时没清理引用，GC 回收了 stream，但 recorder 还持有着“僵尸”对象
- 调用了
-
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 不要手动 stop 整个 stream 来“关麦”，改用
track.enabled = false -
mediaRecorder.stop()后，必须新建MediaRecorder实例才能再次使用，不能复用 - 监听
stream.oninactive，流失效时主动重置 recorder 状态和 UI
- 不要手动 stop 整个 stream 来“关麦”，改用
录音无声 / 只有静音 Blob，但 MediaStream 明明拿到了
这不是流“不支持”，而是流里没有可用音频轨道，或轨道被静音/禁用。
-
常见错误现象：
-
getUserMedia({ audio: true })成功，但设备实际没麦克风（如某些云桌面、无音频硬件的服务器渲染环境） - Safari 旧版本要求写成
{ audio: true, video: false }，单写{ audio: true }可能返回空流 - 流来自
videoEl.captureStream()，但视频元素没播放、没音频轨道、或 iOS Safari 根本不支持该 API
-
-
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 检查
stream.getAudioTracks()是否为空数组，再检查track.readyState === 'live'和track.enabled === true - 对 Safari 11+ 兜底：加
video: false约束；对 iOS，放弃captureStream()，改用 getUserMedia + Web Audio 合成（若允许录系统声则需服务端中转） - 不要依赖
stream.clone()—— clone 出的流共享底层轨道，原 stream 一 stop，clone 的也失效
- 检查
真正卡住人的，从来不是“怎么开始录音”，而是“怎么让流在页面切换、组件卸载、权限变化、多设备共存时持续有效”。很多问题表面是 API 报错，根子在生命周期管理松散。别急着写 start()，先盯住 stream 的创建、持有、释放这三步是否闭环。
