Spring控制器返回音频文件字节，HTML音频播放器无法快进退问题

问题场景 #

我编写了一个Spring控制器，原本计划返回音频文件的部分字节（测试阶段返回文件全部字节），代码如下：

@GetMapping("/voice")
@CrossOrigin
public ResponseEntity<byte[]> streamBytes(
        @RequestParam(name = "name") String name) throws IOException {
    File file = new File(getClass().getResource("/static/" +
            calculatePath(name)).getFile());

    byte[] fileContent = Files.readAllBytes(file.toPath());
    int numBytes = fileContent.length;
    return ResponseEntity.status(HttpStatus.OK)
            .contentType(MediaType.parseMediaType("audio/mpeg"))
            .body(Arrays.copyOfRange(fileContent, 0, numBytes));
}

该控制器路径用于HTML的audio标签：

<audio id='audioPlayer' src='controllerPath'></audio>

音频可正常加载播放，但播放器无法快进或快退；直接访问文件URL（如http://localhost:8082/file.mp3）时，播放器可正常快进退。尝试将HttpStatus.OK改为HttpStatus.PARTIAL_CONTENT后，播放器完全无法播放文件。

核心原因分析 #

1. 无法快进快退的直接原因 #

播放器的快进/快退功能依赖HTTP范围请求机制：当用户拖动进度条时，浏览器会向服务器发送带有Range请求头的请求，要求获取音频文件的特定字节区间。你的控制器存在两个致命问题：

• 完全忽略客户端发送的Range请求头，无论客户端请求哪段内容，都返回整个文件的全部字节。
• 未返回支持范围请求的关键响应头：比如Accept-Ranges: bytes（告知客户端服务器支持范围请求）、Content-Length（明确返回内容的字节长度）。没有这些信息，播放器无法识别文件的可定位区间，只能从头播放。

2. 改为PARTIAL_CONTENT后无法播放的原因 #

HttpStatus.PARTIAL_CONTENT(206)是范围请求成功时的专用响应状态码，但你的实现完全不符合206响应的规范：

• 没有解析客户端的Range请求，依然返回整个文件的全部内容，违背了206状态码的语义（必须对应部分内容的请求）。
• 缺少Content-Range响应头，客户端无法识别返回内容在整个文件中的区间位置，导致播放器无法处理该响应。

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