根本原因是视频编码、mime类型或内核解码能力不匹配；须用ffprobe验证h.264+aac编码，确保服务器返回video/mp4等正确mime，更新widevine与ffmpeg解码器，禁用硬件加速并清除gpucache/shadercache。
米侠浏览器播放网页HTML5视频时提示“格式不支持”，说明浏览器已加载到video标签但拒绝解码该文件，根本原因不是路径错误或网络中断，而是视频编码、MIME类型或内核解码能力三者中至少有一项不匹配。
验证视频真实编码格式
别只看文件后缀名——.mp4可能是H.265、AV1甚至FLV封装，这些格式米侠浏览器默认不支持。用FFmpeg命令行确认：ffprobe -v quiet -show_entries stream=codec_name,width,height -of default input.mp4。
必须同时满足：视频流codec_name=h264、音频流codec_name=aac。若出现h265、av1、vp9等，立即转码。
转码命令示例：ffmpeg -i input.mp4 -c:v libx264 -profile:v baseline -level 3.0 -c:a aac -b:a 128k output.mp4。这一步强制输出H.264+AAC组合，兼容性最高。
检查服务器返回的Content-Type头
即使视频编码完全正确，如果Web服务器没告诉浏览器“这是个视频”，米侠会直接跳过解码流程，页面白屏且控制台无明显报错。
打开开发者工具（F12）→ Network标签 → 刷新页面 → 找到视频请求（如video.mp4）→ 点击它 → 查看Headers面板里的Content-Type字段。
正确值必须是video/mp4（MP4）、video/webm（WebM）或application/vnd.apple.mpegurl（HLS）。若显示text/plain、application/octet-stream或为空，说明服务器配置错误。
Nginx用户需在配置中加入：location ~* \.(mp4|webm|ogg)$ { add_header Content-Type video/$1; }；Apache用户需在.htaccess中加AddType video/mp4 .mp4；IIS用户必须手动在MIME类型里添加.mp4 → video/mp4。
强制更新Widevine CDM与FFmpeg解码器
米侠浏览器内置的解码模块可能陈旧或损坏，尤其当视频来自Netflix、爱奇艺等DRM站点时，老版本CDM无法处理新密钥协议。
方法一：在地址栏输入mi://components回车 → 找到“Widevine Content Decryption Module”和“FFmpeg Video Decoder” → 若任一显示“检查更新”按钮，立即点击；若FFmpeg版本低于v5.8.2（如v5.7.0），必须点“更新”拉取最新版。
【更新后必须彻底关闭所有米侠浏览器窗口，包括后台进程，否则新解码器不会加载】。重启后测试同一视频页是否恢复画面。
方法二：若mi://components页面无响应或更新失败，直接卸载当前米侠浏览器 → 前往官网下载最新安装包 → 覆盖安装。新版安装包会重置全部解码组件并同步最新CDM。
禁用硬件加速并启用软件渲染
部分集成显卡（尤其是高通骁龙6系/7系芯片的安卓设备）驱动与米侠GPU合成模块存在冲突，导致H.264帧解码成功却无法提交至屏幕，结果就是纯音频输出或黑屏。
第一步：在地址栏输入mi://flags回车 → 搜索hardware acceleration → 找到“Hardware-accelerated video decode” → 下拉设为“Disabled”。
第二步：继续搜索renderer → 找到“Override software rendering list” → 设为“Enabled”。
第三步：点击右下角“重启浏览器”按钮生效。这一步绕过GPU驱动层，强制走CPU软解，对老旧机型效果立竿见影。
清除GPUCache、ShaderCache与媒体缓存
损坏的着色器缓存会导致video元素成功解码但帧无法提交至合成器，现象是视频有声音无画面，或画面卡在第一帧不动。
在地址栏输入mi://settings/clearBrowserData回车 → 勾选“GPUCache”“ShaderCache”“媒体缓存”三项 → 时间范围选“全部时间” → 点击“清除数据”。
清除过程中不要切换标签页或关闭窗口。完成后再彻底重启浏览器——这一步能修复因GPU驱动异常引发的合成失败问题。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
