Android中ExoPlayer带请求头播放视频遇403错误求解决

问题描述 #

需要播放Cloudflare R2存储的受权限保护的视频，必须携带指定请求头才能访问，使用ExoPlayer实现时出现403错误，现有代码的请求头配置或参数存在问题，需提供可行的实现方案。

视频地址：https://{{account-info}}.r2.cloudflarestorage.com/test/test-video.mp4

当前使用代码 #

String url = "https://{{account-info}}.r2.cloudflarestorage.com/test/test-video.mp4";
simpleExoPlayer = new ExoPlayer.Builder(this)
        .setMediaSourceFactory(new DefaultMediaSourceFactory(headers()))
        .setTrackSelector(trackSelector)
        .setLoadControl(loadControl)
        .build();
mediaItem = MediaItem.fromUri(url);
simpleExoPlayer.addMediaItem(mediaItem);
simpleExoPlayer.prepare();
simpleExoPlayer.play();

// 请求头配置方法
private DataSource.Factory headers() {
    Map<String, String> headersMap = new HashMap<>();
    headersMap.put("Authorization", "auth");
    headersMap.put("X-Amz-Content-Sha256", "Content");
    headersMap.put("X-Amz-Date", "20221217T154926Z");
    headersMap.put("Content-Type", "application/json");
    return new DefaultHttpDataSource.Factory().setDefaultRequestProperties(headersMap);
}

错误日志 #

E/ExoPlayerImplInternal: Playback error
      com.google.android.exoplayer2.ExoPlaybackException: Source error
        at com.google.android.exoplayer2.ExoPlayerImplInternal.handleIoException(ExoPlayerImplInternal.java:641)
        at com.google.android.exoplayer2.ExoPlayerImplInternal.handleMessage(ExoPlayerImplInternal.java:613)
        at android.os.Handler.dispatchMessage(Handler.java:103)
        at android.os.Looper.loop(Looper.java:214)
        at android.os.HandlerThread.run(HandlerThread.java:67)
     Caused by: com.google.android.exoplayer2.upstream.HttpDataSource$InvalidResponseCodeException: Response code: 403
        at com.google.android.exoplayer2.upstream.DefaultHttpDataSource.open(DefaultHttpDataSource.java:396)
        at com.google.android.exoplayer2.upstream.StatsDataSource.open(StatsDataSource.java:84)
        at com.google.android.exoplayer2.source.ProgressiveMediaPeriod$ExtractingLoadable.load(ProgressiveMediaPeriod.java:1009)
        at com.google.android.exoplayer2.upstream.Loader$LoadTask.run(Loader.java:412)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641)
        at java.lang.Thread.run(Thread.java:919)

解决方案 #

核心问题排查 #

你当前代码的403错误主要由两个原因导致：

1. 请求头参数无效：X-Amz-Date使用的是2022年的过期时间，Cloudflare R2的签名验证会直接拒绝；Content-Type设置为application/json错误，视频文件应使用video/mp4。
2. 需确保Authorization、X-Amz-Content-Sha256等参数符合S3兼容的签名规则，可先用Postman等工具验证请求头的有效性。

可行实现方式 #

方式一：全局配置请求头（适用于所有MediaItem共用同一请求头）

如果所有视频都需要相同的权限头，可全局配置DataSourceFactory：

// 引入依赖（如果用OkHttpDataSource，需添加此扩展）
// implementation "com.google.android.exoplayer:exoplayer-okhttp:2.X.X"

private DataSource.Factory createAuthDataSourceFactory() {
    Map<String, String> validHeaders = new HashMap<>();
    // 替换为有效的请求头参数
    validHeaders.put("Authorization", "正确的Auth签名");
    validHeaders.put("X-Amz-Content-Sha256", "正确的内容哈希值");
    validHeaders.put("X-Amz-Date", "当前UTC时间，格式如20240520T123456Z");
    validHeaders.put("Content-Type", "video/mp4");

    // 选项1：使用DefaultHttpDataSource
    return new DefaultHttpDataSource.Factory()
            .setDefaultRequestProperties(validHeaders)
            .setAllowCrossProtocolRedirects(true); // 开启重定向支持（按需）

    // 选项2：使用OkHttpDataSource（兼容性更强，支持自定义OkHttp配置）
    // OkHttpClient okHttpClient = new OkHttpClient.Builder()
    //         .connectTimeout(30, TimeUnit.SECONDS)
    //         .build();
    // return new OkHttpDataSource.Factory(okHttpClient)
    //         .setDefaultRequestProperties(validHeaders);
}

// 初始化ExoPlayer
private void initExoPlayer() {
    String videoUrl = "https://{{account-info}}.r2.cloudflarestorage.com/test/test-video.mp4";
    
    TrackSelector trackSelector = new DefaultTrackSelector(this);
    LoadControl loadControl = new DefaultLoadControl();
    
    MediaSourceFactory mediaSourceFactory = new DefaultMediaSourceFactory(this)
            .setDataSourceFactory(createAuthDataSourceFactory());
    
    ExoPlayer exoPlayer = new ExoPlayer.Builder(this)
            .setTrackSelector(trackSelector)
            .setLoadControl(loadControl)
            .setMediaSourceFactory(mediaSourceFactory)
            .build();
    
    MediaItem mediaItem = MediaItem.fromUri(videoUrl);
    exoPlayer.addMediaItem(mediaItem);
    exoPlayer.prepare();
    exoPlayer.play();
    
    // 绑定到PlayerView
    // playerView.setPlayer(exoPlayer);
}

方式二：单个MediaItem配置请求头（适用于不同视频用不同权限）

如果不同视频需要不同的请求头，可直接给MediaItem设置专属头：

private void initExoPlayer() {
    String videoUrl = "https://{{account-info}}.r2.cloudflarestorage.com/test/test-video.mp4";
    
    // 构造有效的请求头
    Map<String, String> validHeaders = new HashMap<>();
    validHeaders.put("Authorization", "正确的Auth签名");
    validHeaders.put("X-Amz-Content-Sha256", "正确的内容哈希值");
    validHeaders.put("X-Amz-Date", "当前UTC时间");
    validHeaders.put("Content-Type", "video/mp4");
    
    // 创建带请求头的MediaItem
    MediaItem mediaItem = MediaItem.Builder.fromUri(videoUrl)
            .setRequestHeaders(validHeaders)
            .build();
    
    TrackSelector trackSelector = new DefaultTrackSelector(this);
    LoadControl loadControl = new DefaultLoadControl();
    
    ExoPlayer exoPlayer = new ExoPlayer.Builder(this)
            .setTrackSelector(trackSelector)
            .setLoadControl(loadControl)
            .build();
    
    exoPlayer.addMediaItem(mediaItem);
    exoPlayer.prepare();
    exoPlayer.play();
    
    // playerView.setPlayer(exoPlayer);
}

额外注意事项 #

• 优先用Postman验证请求头的有效性，确保能正常获取视频后再移植到代码中。
• 如果使用签名生成逻辑，需确保签名算法符合Cloudflare R2的要求（兼容AWS S3 v4签名）。
• 记得在Activity/Fragment销毁时释放ExoPlayer资源，避免内存泄漏：exoPlayer.release();

内容的提问来源于stack exchange，提问作者MDEV