Node Express中如何根据ETag判断响应是否将返回304状态码

Express的304未修改状态码逻辑由内置的fresh模块自动处理，默认作用于所有路由响应和express.static托管的静态资源，无需手动编写判断代码，若需要记录该触发事件，可通过自定义中间件实现：

• 触发304的ETag匹配核心条件

  1. 请求方法为GET或HEAD
  2. 原始响应状态码为200
  3. 请求头If-None-Match携带的值与响应头ETag值匹配（支持弱ETag匹配，即前缀带W/的ETag会忽略前缀比对）

• 记录304触发日志的实现代码
  在所有路由和express.static中间件之前注册全局中间件，劫持响应的end方法，在响应发送前完成匹配判断和日志记录：

  app.use((req, res, next) => {
    // 保存原始响应end方法
    const originalEnd = res.end;
    res.end = function(chunk, encoding) {
      const reqEtag = req.headers['if-none-match']?.replace(/^W\//, '');
      const resEtag = res.getHeader('ETag')?.replace(/^W\//, '');
      const isEtagTrigger304 = 
        (req.method === 'GET' || req.method === 'HEAD') &&
        reqEtag && resEtag && reqEtag === resEtag && res.statusCode === 200;
  
      if (isEtagTrigger304) {
        // 此处添加你的日志记录逻辑
        console.log(`请求路径${req.path}因ETag匹配触发304，对应ETag值：${resEtag}`);
        // 无需手动修改状态码，Express会自动处理为304
      }
  
      // 执行原始响应逻辑
      originalEnd.call(this, chunk, encoding);
    }
    next();
  });
  

• express.static适配注意事项
  无需修改express.static的默认配置即可适配上述中间件，若需要关闭静态资源的ETag生成能力，可在初始化时传入配置express.static('静态资源目录', { etag: false })。

内容的提问来源于stack exchange，提问作者Eduardo Poço