需检查原生权限配置与WebView媒体支持：Android须动态申请RECORD_AUDIO并启用mediaCapture，iOS需Info.plist声明、WKWebView配置mediaCapture且由用户手势触发。
检查 navigator.mediaDevices.getUserMedia 是否被拒绝或静默失败
HTML5 转 APP（如 Cordova、Capacitor、WebView 封装）中调用麦克风最常见问题是 getUserMedia 没报错但也不触发授权弹窗，甚至直接 resolve 空流 —— 这通常不是代码写错了，而是底层权限没透传或 WebView 未启用媒体支持。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在调用前加
console.log(navigator.mediaDevices)，确认非undefined；Android WebView 60+ / iOS WKWebView 需显式启用mediaCapture支持 - 不要只监听
then()，必须同时写catch(e => console.error('mic err:', e))，常见错误码：NotAllowedError（权限被拒）、NotFoundError（无可用设备）、NotReadableError（硬件忙或被占用） - 部分安卓 WebView（尤其系统级）会静默拒绝，不抛异常也不弹窗，此时需检查 APP 层是否已申请
RECORD_AUDIO权限且用户手动开启
Android 原生层是否真正申请了 RECORD_AUDIO 权限
Cordova 或 Capacitor 封装时，config.xml 或 AndroidManifest.xml 声明权限只是第一步，Android 6.0+ 还要求运行时动态申请，而很多 WebView 容器默认不自动处理这个流程。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- Cordova 用户：确认已安装
cordova-plugin-android-permissions，并在 JS 中主动调用cordova.plugins.androidPermissions.requestPermission请求cordova.plugins.androidPermissions.PERMISSION.RECORD_AUDIO - Capacitor 用户：检查
android/app/src/main/AndroidManifest.xml是否含MainActivity.java或MainApplication.java中调用了Capacitor.applyAndroidPermissions()（v5+ 默认启用，但自定义 Activity 可能绕过） - 真机测试时，进系统设置 → 应用 → 你的 APP → 权限 → 确认「麦克风」开关为「允许」，而非「仅在使用中允许」或「拒绝」
iOS WKWebView 下 getUserMedia 无响应的硬性限制
iOS 对 WebView 中的媒体采集卡得极严：即使网页 HTTPS、APP 已声明 NSMicrophoneUsageDescription，WKWebView 默认仍禁用麦克风访问，除非明确启用 mediaCapture capability 并满足上下文条件。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保
Info.plist包含NSMicrophoneUsageDescription字符串（否则直接崩溃或静默失败） - Capacitor v4+：在
capacitor.config.ts中设ios: { mediaCapture: true }；Cordova 需插件如cordova-plugin-ios-camera-perms并 patch WKWebView 配置 - 调用
getUserMedia必须由用户手势（如click、touchend）触发，不能在页面加载、定时器或 Promise resolve 后自动调用，否则 iOS 直接拒绝 - 部分 iOS 版本（如 16.4+）对非全屏视频标签的音频采集更敏感，可尝试加
playsinline和muted属性辅助建立媒体上下文
真机调试时如何快速验证是权限问题还是硬件问题
别依赖模拟器——它根本没真实麦克风。直接连真机，用最小闭环验证链路是否通。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 写一个仅含
button和 5 行 JS 的 HTML 文件：document.querySelector('button').onclick = () => navigator.mediaDevices.getUserMedia({ audio: true }).then(s => console.log('ok', s)).catch(e => console.error(e))，本地起服务（python3 -m http.server），用手机浏览器打开，先测是否能授权；再打包进 APP 测，对比行为差异 - 换一台同系统版本的手机重试，排除单台设备麦克风硬件故障或系统策略封禁（如企业 MDM 策略禁用录音）
- 用系统自带录音机 App 录一段音，确认硬件和基础驱动正常；再看系统设置里该 APP 的麦克风权限是否灰显不可点（说明系统级禁止，比如“屏幕使用时间”限制了录音）
最容易被忽略的是：iOS WKWebView 的媒体能力不是“开权限就自动有”，它依赖一次合法的用户手势 + 正确的 WebView 初始化配置 + Info.plist 描述字符串三者同时到位；而 Android 的坑常藏在“权限声明了，但没运行时申请”或“WebView 未启用 mediaCapture”。别只盯着 JS 代码查，得一层层往下敲到原生层。
