Jetty环境下HTML5长视频播放跳转至结尾问题排查请求

我之前在Jetty环境下踩过类似的HTML5音视频流坑，你的情况大概率是大文件范围请求的字节计算异常导致的——毕竟短视频没问题，长视频到75%跳结尾，刚好对应大文件处理时的常见溢出或解析bug。结合你的日志（只有206 Partial Content，无错误），给你几个针对性的排查和解决步骤：

1. 先升级Jetty到稳定新版本 #

老版本Jetty（比如9.x早期版本）在处理大文件Range请求时存在32位整数溢出的问题——当文件大小或请求的字节范围超过2^31-1（约2GB）时，整数截断会导致Jetty错误地返回文件末尾内容。建议直接升级到Jetty 9.4.x以上，或者11.x/12.x的稳定版，这类基础bug在新版本里已经被修复。

2. 检查并修正DefaultServlet配置 #

如果用Jetty自带的DefaultServlet做静态文件服务，确保配置里启用了正确的范围请求支持，并且给大文件留足配置空间：

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.eclipse.jetty.servlet.DefaultServlet</servlet-class>
    <!-- 确保开启范围请求（默认是true，但可能被意外覆盖） -->
    <init-param>
        <param-name>acceptRanges</param-name>
        <param-value>true</param-value>
    </init-param>
    <!-- 设置最大允许的文件大小，用64位数值，比如10GB -->
    <init-param>
        <param-name>maxFileSize</param-name>
        <param-value>10737418240</param-value>
    </init-param>
    <!-- 禁用文件映射缓冲区，大文件场景下容易出问题 -->
    <init-param>
        <param-name>useFileMappedBuffer</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

其中useFileMappedBuffer是关键——这个参数默认开启用来提升小文件性能，但超大文件下会导致内存映射异常，间接引发Range请求解析错误。

3. 手动验证Range请求的正确性 #

用curl模拟浏览器的Range请求，确认Jetty返回的内容是否符合预期：

curl -v -H "Range: bytes=750000000-" http://你的域名/你的长视频路径.mp4

重点看响应头里的Content-Range，正常应该返回bytes 750000000-<实际文件总字节数>/<实际文件总字节数>；如果返回的是bytes <实际文件总字节数>-<实际文件总字节数>/<实际文件总字节数>，说明Jetty错误地认为请求范围超出了文件长度，直接返回了结尾。

4. 排查视频文件本身的索引问题 #

虽然短视频没问题，但长视频可能存在索引位置不合理的情况（比如moov原子在文件末尾），导致浏览器请求Range时无法正确定位。可以用ffmpeg重新生成视频索引：

ffmpeg -i 原视频.mp4 -c:v copy -c:a copy -movflags faststart 修复后的视频.mp4

这个命令会把视频的元数据（moov原子）移到文件开头，帮助浏览器更好地处理分段请求。

5. 如果是自定义Servlet处理视频 #

如果你是用自己写的Servlet返回视频流，一定要确保代码里用long类型处理字节范围——别用int！比如获取文件长度用file.length()（返回long），解析Range头里的起始/结束位置时也用long存储，避免整数溢出导致计算错误。

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