基于Spring Framework与Chrome的视频流服务配置问题排查

首先，你遇到的问题核心是Chrome对HTTP 206部分响应的校验比Firefox更严格，尤其是响应头的完整性和格式。以下是具体的排查点和修复方案：

一、必须修复的响应头问题 #

Chrome对206响应的头信息要求非常严格，缺少或格式错误都会导致它停止加载：

1. 确保返回正确的Content-Range头 #

当处理Range请求时，206响应必须包含Content-Range头，格式为：

Content-Range: bytes start-end/totalSize

比如文件总大小是100000字节，请求Range: bytes=0-，则应该返回Content-Range: bytes 0-99999/100000，而不是只返回总大小。

2. 206响应的Content-Length必须是当前返回的字节数 #

很多人会错误地把总文件大小放到206的Content-Length里，这会导致Chrome误以为已经接收了全部数据，停止后续请求。正确的做法是计算当前返回的字节范围长度（end - start + 1），并把这个值设为Content-Length。

3. 不要遗漏Accept-Ranges: bytes头 #

即使是206响应，也应该保留这个头，告诉Chrome服务支持范围请求。

二、Spring端的正确实现步骤 #

这里提供一个完整的Spring Controller实现示例，处理Range请求并正确和S3交互：

1. 解析Range请求头 #

首先从HttpServletRequest中获取Range头，解析出起始和结束位置：

private Range parseRangeHeader(HttpServletRequest request, long fileSize) {
    String rangeHeader = request.getHeader("Range");
    if (rangeHeader == null || !rangeHeader.startsWith("bytes=")) {
        return new Range(0, fileSize - 1); // 默认返回整个文件
    }
    // 解析Range，比如bytes=0- 或 bytes=100-200
    String[] rangeParts = rangeHeader.substring(6).split("-");
    long start = Long.parseLong(rangeParts[0]);
    long end = rangeParts.length > 1 && !rangeParts[1].isEmpty() 
        ? Long.parseLong(rangeParts[1]) 
        : fileSize - 1;
    // 确保end不超过文件大小
    end = Math.min(end, fileSize - 1);
    return new Range(start, end);
}

// 辅助类
static class Range {
    long start;
    long end;
    Range(long start, long end) {
        this.start = start;
        this.end = end;
    }
}

2. 从S3获取指定范围的数据流 #

使用AWS SDK的GetObjectRequest设置Range参数，获取对应的流：

private S3Object getS3ObjectRange(String bucketName, String key, Range range) {
    GetObjectRequest request = GetObjectRequest.builder()
        .bucket(bucketName)
        .key(key)
        .range(String.format("bytes=%d-%d", range.start, range.end))
        .build();
    return s3Client.getObject(request);
}

3. 构造正确的ResponseEntity #

根据是否是Range请求，返回200或206响应，并设置所有必要的头：

@GetMapping("/stream/{key}")
public ResponseEntity<InputStreamResource> streamS3File(@PathVariable String key, HttpServletRequest request) {
    // 1. 获取S3文件元数据（先不下载文件）
    HeadObjectResponse headObject = s3Client.headObject(HeadObjectRequest.builder()
        .bucket("your-bucket")
        .key(key)
        .build());
    long fileSize = headObject.contentLength();
    String contentType = headObject.contentType();

    // 2. 解析Range请求
    Range range = parseRangeHeader(request, fileSize);
    boolean isPartial = !(range.start == 0 && range.end == fileSize - 1);

    // 3. 获取S3范围流
    S3Object s3Object = getS3ObjectRange("your-bucket", key, range);
    InputStream inputStream = s3Object.getObjectContent();

    // 4. 构造响应头
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.parseMediaType(contentType));
    headers.set("Accept-Ranges", "bytes");
    long contentLength = range.end - range.start + 1;

    if (isPartial) {
        // 206 Partial Content响应
        headers.setContentLength(contentLength);
        headers.set("Content-Range", String.format("bytes %d-%d/%d", range.start, range.end, fileSize));
        return new ResponseEntity<>(new InputStreamResource(inputStream), headers, HttpStatus.PARTIAL_CONTENT);
    } else {
        // 200 OK响应（当Range是0-文件末尾时，有些浏览器会发这个请求）
        headers.setContentLength(fileSize);
        return new ResponseEntity<>(new InputStreamResource(inputStream), headers, HttpStatus.OK);
    }
}

三、额外的排查点 #

• 检查S3返回的流是否完整：有时候如果S3客户端配置了超时或缓冲区大小，可能会导致流提前关闭。可以在本地测试读取流的字节数是否等于计算的contentLength。
• Chrome的缓存问题：有时候Chrome会缓存错误的响应头，测试时可以打开开发者工具（F12），在Network标签勾选"Disable cache"，然后重新加载页面。
• MediaType是否正确：确保返回的contentType是正确的音视频类型，比如video/mp4、audio/mpeg等，错误的类型会导致Chrome无法识别播放。

四、为什么Firefox正常？ #

Firefox对206响应的容错性更强，即使Content-Range格式略有问题或Content-Length设置错误，它仍会尝试继续请求后续块。但Chrome遵循HTTP规范更严格，必须完全符合要求才能正常播放。

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