TV浏览器HTML5弹幕异常的根本原因是内核老旧导致Web API支持残缺，缺乏WebSocket、requestAnimationFrame、Canvas 2D及MediaSource等关键能力，且video元素常被私有组件替代、CSS定位失效、JS性能差、WebSocket被拦截，需逐设备兼容适配。
TV浏览器中HTML5弹幕异常，根本原因在于其内核老旧、Web API支持残缺，且缺乏对现代弹幕系统关键能力（如 WebSocket、requestAnimationFrame、Canvas 2D 高精度渲染、MediaSource 动态分片）的完整实现。绝大多数TV浏览器基于定制版WebKit或极旧Chromium（如 Android TV 6.0 内置WebView），连 Promise 都可能不原生支持，更别说弹幕所需的实时时间轴同步与批量DOM高效插入。
TV浏览器不支持 document.querySelector('video') 或返回 null
这是最典型的“弹幕压根不启动”信号——播放器底层未成功挂载HTML5 元素，或被TV系统强制替换为私有视频组件（如三星Tizen的AVPlay）。此时所有依赖该元素的弹幕JS逻辑（如监听timeupdate、获取video.currentTime）全部失效。
- 打开开发者工具（如有）或用遥控器触发控制台（部分厂商支持
adb shell input keyevent KEYCODE_DPAD_CENTER模拟点击），执行document.querySelector('video')；若返回null，说明播放器不是标准HTML5实现 - 检查页面是否加载了降级方案脚本（如检测到
navigator.userAgent含Tizen/WebOS/VIDAA就跳过弹幕初始化） - 不要尝试强行注入
video标签——TV系统会拦截或忽略，反而触发安全策略报错
z-index 和 position: fixed 在TV端完全失效
TV浏览器对CSS层叠上下文处理极其简陋：即使设置了z-index: 9999，只要父容器有transform、opacity或overflow: hidden（TV UI框架常用），弹幕层就会被裁剪或压在底层。更糟的是，很多TV浏览器根本不识别position: fixed，导致弹幕随页面滚动或缩放而错位。
- 必须将弹幕容器直接
appendChild到document.body，绕过所有中间容器 - 放弃
fixed，改用absolute+ 手动监听resize和scroll事件动态重定位（TV端scroll极少发生，但resize必须响应） - 用
getBoundingClientRect()而非offsetTop/Left计算视频位置——后者在TV上常返回0
弹幕文字模糊、卡顿、大量丢帧
TV设备GPU驱动封闭、内存紧张、JavaScript引擎无JIT优化（如V8未启用TurboFan），导致每条弹幕创建div并设置left动画的常规做法直接崩盘。10条/秒的弹幕流即可让CPU飙高、帧率跌破10fps。
立即学习“前端免费学习笔记（深入）”；
- 禁用所有CSS transition/animation，改用
requestAnimationFrame手动更新style.left（若TV支持该API；否则降级为setTimeout，间隔设为100ms） - 预创建20个弹幕
div节点池，重复使用，避免频繁document.createElement - 文字渲染强制用
canvas 2D绘制（需先检测document.createElement('canvas').getContext('2d')是否存在），规避字体回退和抗锯齿失控问题 - 主动限流：根据
performance.now()差值判断是否跳过本轮渲染，确保主线程不阻塞
WebSocket连接失败或弹幕消息收不到
TV浏览器常禁用或阉割WebSocket，尤其在非HTTPS页面、或域名未列入白名单时静默失败。部分厂商甚至把ws://协议直接拦截为非法请求。
- 优先尝试
EventSource（SSE）作为备选，它基于HTTP长连接，在TV端兼容性远高于WebSocket - 若必须用WebSocket，连接前加探测：
try { new WebSocket('wss://test.example.com') } catch(e) { /* 切降级通道 */ } - 禁止使用
ws://明文协议——TV系统普遍拒绝，必须wss://且证书有效 - 心跳保活间隔拉长至
60s以上，避免TV休眠机制断开空闲连接
TV端弹幕不是“写个HTML+JS就能跑”，而是要逐设备做兼容适配。最容易被忽略的一点：很多TV浏览器的console根本不可见，错误全被吞掉。上线前必须用localStorage记录关键路径日志（如“video found”、“ws connected”、“barrage rendered #3”），再通过ADB或厂商调试工具捞取，否则连问题出在哪都定位不了。
