基于HLS的HTTP视频流服务器问题：文件被下载而非播放

看起来你在搭建HLS流服务器时遇到了典型的响应处理问题——浏览器把.m3u8当文件下载、VLC无法播放，这主要是因为你的响应没有正确支持HLS的核心特性，我来给你拆解问题并给出修复方案：

问题根源分析 #

你的当前实现有几个关键缺陷：

• 未支持字节范围请求（Range Requests）：HLS播放器（包括浏览器和VLC）会通过Range头分段请求媒体内容，但你直接返回了整个文件，播放器无法识别这是可流式处理的内容，只能触发下载。
• Content-Type覆盖不全：你只设置了application/x-mpegURL，但HLS还包含.ts媒体分片文件，这类文件需要设置video/MP2T类型，否则播放器无法解析。
• 内存低效的文件读取：把整个文件读成字符串再转字节，不仅浪费内存，也不符合流媒体“边读边传”的设计思路。

修复后的完整代码 #

private void handleResponse(HttpExchange exchange, String fileNameValue) {
    File file = new File(fileNameValue);
    // 先判断文件是否存在，快速返回404
    if (!file.exists()) {
        try {
            exchange.sendResponseHeaders(404, -1);
            exchange.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return;
    }

    try (OutputStream responseStream = exchange.getResponseBody()) {
        // 根据文件后缀设置正确的Content-Type
        String contentType = fileNameValue.endsWith(".m3u8") 
            ? "application/x-mpegURL" 
            : "video/MP2T";
        exchange.getResponseHeaders().set("Content-Type", contentType);
        exchange.getResponseHeaders().set("Accept-Ranges", "bytes");
        exchange.getResponseHeaders().set("Cache-Control", "max-age=0, no-cache, no-store");

        long fileLength = file.length();
        String rangeHeader = exchange.getRequestHeaders().getFirst("Range");

        if (rangeHeader == null) {
            // 无Range请求，返回完整文件
            exchange.sendResponseHeaders(200, fileLength);
            Files.copy(file.toPath(), responseStream);
        } else {
            // 处理字节范围请求，返回206 Partial Content
            String[] rangeParts = rangeHeader.replace("bytes=", "").split("-");
            long start = Long.parseLong(rangeParts[0]);
            // 如果Range没有指定结束位置，默认到文件末尾
            long end = rangeParts.length > 1 ? Long.parseLong(rangeParts[1]) : fileLength - 1;
            long contentLength = end - start + 1;

            // 设置Content-Range响应头
            exchange.getResponseHeaders().set(
                "Content-Range", 
                String.format("bytes %d-%d/%d", start, end, fileLength)
            );
            exchange.sendResponseHeaders(206, contentLength);

            // 分段读取文件，避免加载整个文件到内存
            try (RandomAccessFile raf = new RandomAccessFile(file, "r")) {
                raf.seek(start);
                byte[] buffer = new byte[8192];
                long remaining = contentLength;
                while (remaining > 0) {
                    int readBytes = raf.read(buffer, 0, (int) Math.min(buffer.length, remaining));
                    if (readBytes == -1) break;
                    responseStream.write(buffer, 0, readBytes);
                    remaining -= readBytes;
                }
            }
        }

        responseStream.flush();
    } catch (FileNotFoundException e) {
        try {
            exchange.sendResponseHeaders(404, -1);
            exchange.close();
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

关键修复点说明 #

• 支持Range请求：处理客户端的Range头，返回206 Partial Content状态码，这是HLS播放器能流式加载内容的核心前提。
• 动态Content-Type：根据文件后缀区分.m3u8和.ts文件，确保播放器能正确识别内容类型。
• 流式传输优化：使用Files.copy或RandomAccessFile分段读取文件，避免内存溢出，同时符合流媒体的传输逻辑。
• 错误处理优化：提前判断文件是否存在，快速返回404，减少异常抛出的概率。

相关研究关键词 #

• HLS (HTTP Live Streaming) 字节范围请求
• HttpExchange 处理Range请求头
• HLS Content-Type 配置规范
• Java 轻量流媒体服务器实现
• 206 Partial Content 响应机制

内容的提问来源于stack exchange，提问作者Ngọc Nguyễn