第3章：网络连接失败日志特征与修复

网络连接失败是 ExoPlayer 播放失败的最常见原因之一。本章将系统梳理三种典型网络故障——连接超时、DNS 解析失败、SSL 握手错误——从日志特征到对应修复动作，遵循“现象→采集→定位→修复→复测→预防”的排查闭环。

3.1 现象识别：三种故障的日志指纹

ExoPlayer 内部使用HttpDataSource或其子类执行网络请求。当网络层出现异常时，日志中会留下明确的错误堆栈。以下为三种故障的典型日志片段：

3.2 数据采集：关键信息捕获

定位具体原因需要更详细的数据：

• 完整堆栈：使用 Log.e 或 ExoPlayer 的 EventLogger 输出所有异常链。
• 网络请求参数：记录 URL、请求方法、超时设置（connectTimeoutMs、readTimeoutMs）。
• 设备网络状态：通过 ConnectivityManager 获取当前网络类型（WiFi/蜂窝）、是否连接、是否被代理。
• DNS 解析结果：使用 InetAddress.getAllByName(host) 手动验证。
• 时间戳与延迟：记录从发起请求到抛出异常的时间差（毫秒）。

// 采集示例：EventLogger 配置
DefaultHttpDataSource.Factory factory = new DefaultHttpDataSource.Factory()
    .setConnectTimeoutMs(8000)
    .setReadTimeoutMs(8000);
// 在日志过滤器中输入 "EventLogger" 即可捕获详细网络层日志

3.3 原因定位：故障树与判断规则

使用以下故障树（Fault Tree）快速判断根因：

3.4 修复动作：分类型解决方案

3.4.1 连接超时修复

• 增加超时时间：在 DefaultHttpDataSource.Factory 中设置 setConnectTimeoutMs(15000) 和 setReadTimeoutMs(15000)，避免弱网环境下过早失败。
• 弱网重试策略：使用 ExoPlayer 的 DefaultLoadControl 的 setBackBufferDurationMs 或自定义 HttpDataSource 的拦截器实现指数退避重试。
• 检查代理/防火墙：确认设备是否使用系统代理；若代理不可达，在组件中设置 setAllowCrossProtocolRedirects(true) 并关闭代理。

3.4.2 DNS 解析失败修复

• DNS 预解析：在播放前调用 InetAddress.getByName(host) 并缓存 IP，使用自定义 Dns 实现（实现 okhttp3.Dns 接口）。
• 备用 DNS：在 Android 上使用 Network#getByName 或通过 ConnectivityManager#getActiveNetwork 获取当前网络，主动切换 DNS 服务器（如 8.8.8.8）。
• URL 校验：在日志中输出完整 URL 并比对 CDN 域名是否正确，注意是否包含 http:// 或 https:// 格式错误。

3.4.3 SSL 握手错误修复

• 证书配置：如果服务器使用自签名证书，必须在 OkHttpClient 或 DefaultHttpDataSource 中信任特定证书（使用 CertificatePinner 或自定义 SSLSocketFactory）。
• TLS 版本兼容：ExoPlayer 默认使用系统支持的 TLS 版本。若服务器仅支持 TLS 1.2 以下，可通过 ConnectionSpec 指定兼容列表：

// 示例：使用 OkHttp 作为底层网络栈时配置 TLS
OkHttpClient client = new OkHttpClient.Builder()
    .connectionSpecs(Arrays.asList(
        ConnectionSpec.MODERN_TLS,
        ConnectionSpec.COMPATIBLE_TLS))
    .build();
// 然后传递给 DefaultHttpDataSource.Factory

• SNI 问题：若服务器使用 SNI 多域名，确保 URL 的 Host 与证书 CN 匹配。可在日志中查看 javax.net.ssl.SNIHostName 是否被正确发送。

3.5 复测：验证修复效果

1. 复现环境：使用与原故障相同的网络环境（如弱网模拟器、特定 DNS 配置、无效证书服务器）。
2. 逐步验证：
   • 超时修复：使用 adb shell 设置 iptables -A OUTPUT -p tcp --dport 443 -j DROP 观察超时后的重试行为。
   • DNS 修复：修改 hosts 文件指向错误 IP，验证预解析是否生效。
   • SSL 修复：使用不同 TLS 版本的测试服务器（如 https://tls-v1-0.badssl.com 模拟）确认握手成功。
3. 日志回归：重新捕获播放日志，确认无对应异常抛出。

3.6 预防：建立网络层韧性

完成以上六个步骤后，网络连接失败将不再成为 ExoPlayer 播放的瓶颈。下一环节将进入“HTTP 状态码错误”（4xx/5xx）的排查。