Spring Boot代理HLS视频流异常：无法播放Home Assistant摄像头视频

1. 验证HTTP响应头的完整性与正确性 #

• 直接用curl -v对比直接访问Home Assistant流URL和Spring Boot代理端点的响应头：
  • 必须确保Content-Type正确设置为application/vnd.apple.mpegurl（对应m3u8索引文件）或video/MP2T（对应TS分片）
  • 检查Transfer-Encoding: chunked是否存在，HLS流依赖分块传输，StreamingResponseBody默认支持，但可能被拦截器或过滤器修改
  • 确认Cache-Control、Access-Control-Allow-Origin等头与原请求一致，部分播放器对跨域或缓存策略敏感
• 检查代理请求是否正确携带Home Assistant的授权头：必须在请求头中添加Authorization: Bearer {你的长期令牌}，确保令牌有效且有权限访问摄像头流

2. 排查流式传输的实现细节 #

• 检查StreamingResponseBody的写入逻辑：禁止将流全部读取到内存再输出，必须边读边写，正确示例：

  @Override
  public void writeTo(OutputStream outputStream) throws IOException {
      try (CloseableHttpResponse response = httpClient.execute(request)) {
          InputStream inputStream = response.getEntity().getContent();
          byte[] buffer = new byte[4096];
          int bytesRead;
          while ((bytesRead = inputStream.read(buffer)) != -1) {
              outputStream.write(buffer, 0, bytesRead);
              outputStream.flush(); // 关键：及时刷新输出流，避免数据积压
          }
      }
  }
  

• 确认CloseableHttpClient未启用默认缓存或连接复用策略，这类配置可能导致流中断或延迟
• 排查Spring过滤器（如SecurityFilter、CompressionFilter）是否修改响应流，比如强制GZIP压缩，HLS流通常不需要压缩，且部分播放器不支持压缩后的TS分片

3. 处理HLS流的分片请求代理 #

• HLS流由m3u8索引文件和多个TS分片组成，若代理端点仅处理初始m3u8请求，播放器后续的TS分片请求会失败：
  • 检查Home Assistant返回的m3u8内容中分片URL是绝对路径还是相对路径，若为相对路径，代理需处理所有分片请求的转发
  • 确保Spring Boot端点的URL模式能匹配所有分片请求（比如用/proxy/ha-camera/**而非固定路径），并动态拼接正确的Home Assistant分片URL

4. 日志与调试增强 #

• 开启HttpClient的DEBUG日志，查看请求和响应的详细过程：

  logging.level.org.apache.http=DEBUG
  logging.level.org.apache.http.wire=DEBUG
  

• 在StreamingResponseBody的写入逻辑中添加关键节点日志（如读取字节数、写入字节数），确认数据是否持续稳定传输，而非中断或仅传输部分数据
• 用浏览器开发者工具的Network面板，查看播放器发起的所有请求：检查每个请求的状态码、响应头、响应内容是否与直接访问一致，重点排查TS分片请求是否返回200

5. 替代方案验证 #

• 尝试用HttpComponentsClientHttpRequestFactory结合RestTemplate实现流式传输，避免手动管理CloseableHttpClient的疏漏：

  RestTemplate restTemplate = new RestTemplate();
  HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
  factory.setConnectTimeout(3000);
  restTemplate.setRequestFactory(factory);
  
  ResponseEntity<Resource> response = restTemplate.exchange(
      haStreamUrl,
      HttpMethod.GET,
      new HttpEntity<>(createHeaders(token)),
      Resource.class
  );
  return new ResponseEntity<>(response.getBody(), response.getHeaders(), HttpStatus.OK);
  

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