Node.js + Express生产环境视频流加载异常问题求助

我花了一整天排查这个问题：视频流在本地环境运行顺畅，但部署到生产服务器后出现异常。目前使用Express框架，试过readstream.pipe()和stream pipeline两种方式返回响应，都没用。

负责分块传输视频文件的函数如下：

function getStream(videoPath,req,res){
    const videoSize = fs.statSync(videoPath).size; //file property (sync)

    var range = req.headers.range;
    if (!range) {
      range = 'bytes=0-';
      console.log('wrong start')
    }

    // Parse Range
    const CHUNK_SIZE = 1000000; // 1MB
    const start = parseInt(range.replace(/\D/g, ""),10);
    console.log('start is: ',start);
    const end = Math.min(start + CHUNK_SIZE, videoSize - 1);
    console.log('end is: ',end);
    console.log(`Chunk_size: ${CHUNK_SIZE}`)
    // Create headers
    const contentLength = (end-start) + 1;
    console.log(`contentLength: ${contentLength}`)
    const headers = {
      "Content-Range": `bytes ${start}-${end}/${videoSize}`,
      "Accept-Ranges": "bytes",
      "Content-Length": contentLength,
      "Content-Type": "video/mp4",
    };
    // HTTP Status 206 for Partial Content
    res.writeHead(206, headers);
    // create video read stream for this particular chunk
    const videoStream = fs.createReadStream(videoPath, { start, end });
    // videoStream.pipe(res);
    pipeline(videoStream , res, (err) => {
      err && console.error(err);
    });
}

问题详情：请求的视频无法在HTML5视频播放器中加载，服务器没有抛出任何错误或错误码，所有控制台日志和开发/本地环境完全一致。直接在浏览器访问视频URL时，IDM提示文件损坏且包含不匹配的块，但视频文件本身是正常的。

问题排查与修复方案 #

1. Range头解析逻辑错误（核心问题）
   你当前用range.replace(/\D/g, "")提取start值的方式完全错误——如果播放器发送的是bytes=100-200这类完整范围头，会把所有非数字字符去掉得到100200，直接导致读取的文件块完全偏移，这就是IDM提示块不匹配的根本原因。正确解析方式应该拆分Range字符串：

   // 替换原start解析代码
   const parts = range.replace(/bytes=/, "").split("-");
   const start = parseInt(parts[0], 10);
   // 处理Range为bytes=100-的情况，默认取文件末尾
   const end = parts[1] ? parseInt(parts[1], 10) : videoSize - 1;
   

2. 同步文件状态的潜在风险
   fs.statSync是同步方法，若生产服务器IO性能差或文件过大，会阻塞事件循环；若文件读取时被修改，videoSize也可能不准确。建议换成异步方法：

   async function getStream(videoPath, req, res) {
     try {
       const stats = await fs.promises.stat(videoPath);
       const videoSize = stats.size;
       // 后续逻辑...
     } catch (err) {
       res.status(404).send("Video not found");
       return;
     }
   }
   

3. 禁用视频文件的压缩
   生产服务器若启用了Gzip/Brotli压缩，会破坏视频流的分块结构。如果用了compression中间件，针对视频文件禁用压缩：

   const compression = require('compression');
   app.use(compression({
     filter: (req, res) => {
       if (req.path.endsWith('.mp4')) {
         return false;
       }
       return compression.filter(req, res);
     }
   }));
   

4. 完善错误处理
   当前pipeline的错误回调仅打印日志，未向客户端返回错误，也无法排查权限类问题。补充响应处理：

   pipeline(videoStream, res, (err) => {
     if (err) {
       console.error(err);
       res.status(500).send("Stream error");
     }
   });
   

5. 检查文件权限与缓存
   确认生产服务器上Node进程有视频文件的读取权限；同时检查CDN或反向代理（如Nginx）是否缓存了错误响应，清空缓存后再测试。

优先修复Range头解析问题，这是导致块不匹配的最直接原因。

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