Java Servlet处理Range请求失败，媒体服务器无法返回完整响应

我之前做媒体服务器处理Range请求的时候，也踩过几乎一模一样的坑！结合你说的情况——能拿到Range的起止索引，但浏览器只收到状态码和响应类型，没其他头和内容——大概率是响应头没配全，或者响应体的写入逻辑有问题，咱们一步步来排查：

1. 先把Range请求必备的响应头补全 #

处理Range请求时，必须返回206 Partial Content状态码，同时几个核心响应头一个都不能少，少了浏览器就会不认这个响应：

• Content-Range: 格式是bytes start-end/total，比如bytes 0-1023/4096，其中total是文件总大小，你可以用file.length()获取
• Content-Length: 这里是你要返回的片段长度，也就是end - start + 1（因为索引是闭区间，比如0到1023是1024个字节）
• Accept-Ranges: 固定写bytes，告诉浏览器服务器支持Range请求
• 别忘了保留原有的Content-Type（比如video/mp4，根据你的文件类型调整）

给你一段示例代码参考：

long fileLength = file.length();
// 假设你已经解析出合法的start和end值
long contentLength = end - start + 1;

response.setStatus(HttpServletResponse.SC_PARTIAL_CONTENT);
response.setHeader("Accept-Ranges", "bytes");
response.setHeader("Content-Range", String.format("bytes %d-%d/%d", start, end, fileLength));
response.setHeader("Content-Length", String.valueOf(contentLength));
response.setContentType("video/mp4"); // 替换成你的媒体类型

2. 检查响应体的写入逻辑是否正确 #

你用了RandomAccessFile，一定要注意定位到正确的起始位置，并且严格控制读取的字节数，不能多也不能少：

// 先定位到Range的起始位置
file.seek(start);
byte[] buffer = new byte[4096]; // 用4KB缓冲区比较合适
long remainingBytes = contentLength;
OutputStream out = response.getOutputStream();

try {
    while (remainingBytes > 0) {
        // 每次读取的字节数不能超过缓冲区大小，也不能超过剩余需要发送的字节数
        int readSize = (int) Math.min(buffer.length, remainingBytes);
        int actualRead = file.read(buffer, 0, readSize);
        if (actualRead == -1) break; // 意外情况：文件被截断了
        out.write(buffer, 0, actualRead);
        remainingBytes -= actualRead;
    }
    out.flush(); // 一定要flush，避免数据留在缓冲区没发送
} finally {
    out.close();
    file.close();
}

这里的关键是用remainingBytes来控制总发送量，确保不会超出Range指定的区间。

3. 再确认Range头的解析逻辑有没有漏洞 #

你说已经拿到了起止索引，但还是要检查解析逻辑是否覆盖了所有合法的Range格式：

• bytes=0-：表示从0字节到文件末尾，这时候end应该设为fileLength - 1
• bytes=-1024：表示取最后1024字节，这时候start是fileLength - 1024，end是fileLength - 1
• bytes=1024-2047：指定具体区间

如果你的解析只处理了最后一种情况，其他情况会导致start/end值非法，进而导致后续写入失败。

4. 检查是否有异常被悄悄吞掉 #

如果上面的都没问题，那可能是代码里抛出了异常但没被捕获，比如RandomAccessFile.seek()如果传入的start大于文件长度，会抛出IOException，这时候响应会直接中断，浏览器就只能收到部分内容。建议加上异常捕获并打印日志：

try {
    // 你的Range请求处理逻辑全放在这里
} catch (IOException e) {
    e.printStackTrace(); // 打印错误日志方便排查
    response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); // 返回500错误给浏览器
}

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