audio.play()报NotAllowedError是浏览器策略拦截而非代码错误，必须在用户点击、触摸等手势事件中直接调用play()，禁用DOMContentLoaded或setTimeout调用；iOS和微信需预加载load→play→pause并等待WeixinJSBridgeReady；同时检查路径、MIME类型、编码格式及AudioContext激活状态。
HTML插入音频后无法播放，绝大多数情况不是代码写错了，而是浏览器策略、格式兼容性或加载时机卡住了——直接改代码往往无效，得先定位是哪一层断的。
audio.play() 报 NotAllowedError 怎么办
这是最典型的报错，说明浏览器明确拒绝了播放请求。它和“代码没运行”完全不同，是策略拦截，不是语法错误。
- 不要在
window.onload、DOMContentLoaded或定时器里调用play()，99% 会触发该错误 - 必须绑定到真实用户手势：点击、触摸、键盘按键（
keydown仅限可输入元素） - 推荐一次性绑定：
document.body.addEventListener('click', () => audio.play().catch(e => {}), { once: true }); - 微信 iOS 端还要等
WeixinJSBridgeReady，否则play()直接静音返回，连 Promise 都不 reject
音频文件路径正确但 Network 显示 404 或 net::ERR_BLOCKED_BY_CLIENT
表面是路径问题，实际常是协议或服务器配置导致的加载失败。
- 本地双击 HTML（
file://协议）时，Chrome / Edge 默认禁用音频加载，Firefox 也限制部分格式——必须起本地服务，比如python3 -m http.server 8000 - 检查 Network 面板中音频请求的
Content-Type响应头：要是text/plain或空着，说明服务器没配 MIME 类型；.mp3 应返回audio/mpeg - Apache 加
AddType audio/mpeg .mp3；Nginx 在types块里补audio/mpeg mp3; - 路径含中文或空格？URL 编码可能出错，换成
bg-music.mp3这类纯英文命名更稳
有 controls 但点播放没声音，或显示播放中却无声
界面状态正常 ≠ 声音通路畅通。常见陷阱藏在环境和底层 API 上。
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- 先看 Chrome 地址栏右侧有没有灰色扬声器图标（被 mute），点开取消静音
- 系统音量是否为 0？标签页是否被手动静音？
- 移动端 iOS Safari 对
volume属性只读，设audio.volume = 1无效，只能靠用户自己调 - AudioContext 被挂起：iOS 和新版 Chrome 中，未激活的上下文会导致
play()失败，错误信息类似 “The request is not allowed by the user agent” —— 必须由用户手势首次唤醒 - 用
canplaythrough替代loadeddata判断就绪：后者只表示第一帧加载完，缓冲区可能空，播几秒就卡；前者才代表浏览器预估能一路播完
MP3 文件明明存在，却提示 MEDIA_ERR_SRC_NOT_SUPPORTED（code: 4）
这不是加载失败，是浏览器打开文件后当场解码失败——文件后缀骗不了人，得看真实编码。
- 用
ffprobe your-audio.mp3查流信息，重点看这行：Audio: mp3 (mp3), 44100 Hz, stereo, fltp, 128 kb/s—— 其中fltp（浮点）Safari 不认，s16p（16位整数）才通用 - 别只写一个
src，必须提供 fallback：<source src="a.mp3" type="audio/mpeg"><source src="a.ogg" type="audio/ogg"></source></source> - WAV 格式看似无损，但带 IEEE Float 编码的同样被 Safari 拒绝；Ogg/Vorbis 在 Firefox/Chrome 稳定，但 Safari 完全不支持
- 本地测试时，别信文件管理器显示的“MP3”，用命令行验证编码才是真
真正难搞的从来不是怎么写 audio 标签，而是当它不动声色地失败时，你得知道去 Network 看响应头、去 Console 捕 Promise 错误、去终端查编码、甚至换设备复现 iOS 行为——这些动作比加一行 autoplay 耗时得多，但漏掉任何一个，都可能让音频永远沉默。
