📚 课程目录第4章解码器初始化失败的排查

第4章解码器初始化失败的排查

4.1 现象识别

播放器在加载媒体时快速进入 STATE_ENDED 或直接抛出 ExoPlaybackException 并携带 MediaCodec 相关异常。典型用户感知为：

视频画面黑屏，音频无声，播放器立即停止
某些设备正常，另一些设备（尤其是低端 SoC）却失败
日志中出现“Decoder init failed”“Codec not supported”等关键短语

关键日志特征（摘录自 ExoPlayer 日志）：

E/ExoPlayerImplInternal: Playback error
  com.google.android.exoplayer2.ExoPlaybackException: MediaCodec error
  Caused by: android.media.MediaCodec$CodecException: Error 0x80000000
  at android.media.MediaCodec.native_configure(Native Method)
  ...
E/MediaCodec: Codec not found for format: video/avc, width:1920, height:1080

4.2 数据采集

必要的信息收集清单：

采集项	采集方法	用途
设备型号 & Android 版本	adb shell getprop ro.product.model & ro.build.version.sdk	判断硬件能力与系统限制
ExoPlayer 版本 & 扩展版本	build.gradle 配置	确定已知 bug 或 API 行为
MediaCodec 列表	adb shell dumpsys media.codec	查看系统注册的解码器支持的 MIME/Profile/Level
MediaFormat 日志	开启 ExoPlayer LogLevel 为 ALL	捕获传递给解码器的确切格式参数
设备内存 & 可用内存	adb shell dumpsys meminfo	排查 OOM 导致的对应崩溃

💡 快速采集命令

# 导出所有已注册解码器（部分厂商隐藏非标准 codec）
adb shell dumpsys media.codec | grep -E "name:|type:" > codecs.txt
# 实时过滤 ExoPlayer 播放日志
adb logcat -s "ExoPlayerImplInternal" "MediaCodec*" "ACodec" --format=tag+time

4.3 原因定位

使用结构化故障树快速定位根因：

根据故障树，列出具体判定规则：

现象 / 日志片段	主要原因	判定依据
`Codec not found for format`	硬件解码器不支持	设备 `MediaCodecList` 中不含该 MIME 或 Profile/Level 组合
`native_configure failed: Error 0x80000000`	配置参数非法 / 分辨率超限	通常伴随宽高 > 设备最大解码分辨率（如 4096×2304）
`CodecException: Error 0xFFFFFFFEA`	软件解码器内部崩溃	常见于 FFmpeg 扩展版本与 NDK 不匹配，或异步错误处理缺失
`Could not create codec instance`	内存不足 / 解码器实例受限	同时段 `dumpsys meminfo` 剩余内存 < 200MB

⚠️ 常见误区
不要仅凭“硬件解码器不支持”就直接禁用硬解。部分设备虽然注册了解码器，但对特定分辨率/比特率会静默失败。建议先通过 DecoderQuery 实际测试该码流是否能成功创建 MediaCodec 实例。

4.4 修复动作

针对不同原因，按优先级执行修复：

硬件解码器不支持
- 在 DefaultRenderersFactory 中设置 EXTENSION_RENDERER_MODE_PREFER_SOFTWARE 或硬编码降级到软件解码器。
- 限制请求的 MediaFormat 参数：降低 KEY_MAX_WIDTH/HEIGHT、使用 video/hevc 低 Profile 替代 video/avc high。
软件解码器崩溃
- 升级 ExoPlayer 扩展库版本（如 exoplayer-ffmpeg-extension）至与 NDK 兼容的版本。
- 为 FFmpeg 解码器增加 codecThreads 限制（默认 0 = 自动），防止多线程竞争导致崩溃。
- 捕获 CodecException 并调用 MediaCodec#reset() 重新创建实例。
MediaCodec 异常日志干扰
- 开启 MediaCodecConfiguration#setPriority(0) 降低异步错误的影响。
- 对高频错误码（如 0x80001001）实现独立重试逻辑。

配置示例（在 ExoPlayer 的 TrackSelectionParameters 中限制解码规格）：

// 限制请求视频最大为 1080p，强制软件解码
val params = TrackSelectionParameters.Builder(context)
    .setMaxVideoSize(1920, 1080)
    .setPreferredVideoDecoder(RenderersFactory.EXTENSION_RENDERER_MODE_PREFER_SOFTWARE)
    .build()
player.setTrackSelectionParameters(params)

4.5 复测

修复后需执行以下验证：

回归测试：使用原故障码流再次播放，确认无 MediaCodec 异常抛出，播放到达 STATE_READY。
压力测试：连续切换 10 次不同码流（包括最高分辨率），观察内存和线程数不异常增长。
日志验证：检查 logcat 中不再出现 CodecException 或 Codec not found。

📋 复测 checklist

☑ 排查后日志无新异常
☑ 播放器状态持续 READY 超过 30 秒
☑ 解码器实例计数稳定（adb shell dumpsys media.codec | grep "instances"）
☑ 首帧渲染时间 < 2s （需原故障设备）

4.6 预防

预防措施	实现方式	效果
解码能力预查询	使用 `MediaCodecList.getCodecInfos()` + `isSoftwareOnly()` 过滤	避免创建不支持的硬解码器
自适应降级策略	结合 `AdaptiveTrackSelection` 动态切换低分辨率/低码率	减少超规格码流导致的初始化失败
扩展解码器白名单	只允许经过兼容性验证的 FFmpeg 版本	降低子库崩溃率
异常监控上报	捕获 `PlaybackException` 中 `errorCode` 为 `ERROR_CODE_DECODER_INIT_FAILED` 时上报	快速发现设备兼容性问题

通过以上步骤，可将解码器初始化失败的排查时间从平均 2 小时缩短至 15 分钟，并降低上线后同类问题的新增概率。