Express v5中能否修改req.query？迁移Joi验证遇阻求助

问题描述 #

Express v5 更改了req.query的行为：req.query属性不再是可写属性，而是一个 getter。

在原Express v4应用中，我们用Joi中间件验证请求体、查询参数和路由参数，还能通过Joi给空值设默认值，或者把?inStock=1这类参数转换成{inStock: true}这种格式。现在迁移到v5，这是最后一个卡点——req.body还能正常修改，但req.query没法改了。

有没有办法在中间件里操作req.query？如果实在不行，只能新增req.validatedQuery = validate(schema, req.query)这类属性，然后修改所有请求处理器来用这个新属性，但这方案太麻烦。另外我也搞不懂，为什么body、params、headers都能修改，唯独req.query不行？中间件本来就是用来修改请求或响应的，而且req.query本身就是URL解析后的结果，换解析器都能改它。验证是在中间件管道的不同阶段做的，我觉得应该像处理body那样，在请求到路由处理器前，就能对req.query做转换、清理和标准化。

可行解决方案 #

1. 自定义query解析器（推荐） #

Express允许自定义query parser，可以直接在解析环节整合Joi的验证和转换逻辑，让req.query从一开始就是处理后的结果，无需后续修改。

示例代码：

const express = require('express');
const Joi = require('joi');

const app = express();

// 自定义query解析器
app.set('query parser', (str) => {
  // 先用默认解析器处理原始query字符串
  const defaultParsed = express.queryParser(str);
  // 定义Joi校验规则
  const schema = Joi.object({
    inStock: Joi.boolean().truthy('1').falsy('0').default(false),
    // 其他字段规则...
  });
  // 验证并转换（实际项目需添加错误处理逻辑）
  const { value } = schema.validate(defaultParsed);
  return value;
});

// 路由中直接使用处理后的req.query
app.get('/products', (req, res) => {
  console.log(typeof req.query.inStock); // 输出 boolean
  res.send(req.query);
});

2. 重定义req.query的getter（不推荐，依赖内部实现） #

虽然官方将req.query设为getter，但可以在中间件中重新定义其getter逻辑，让它返回处理后的结果。注意这种方法依赖Express内部实现，后续版本可能失效，需谨慎使用。

示例代码：

app.use((req, res, next) => {
  // 缓存原始query的getter
  const originalQueryGetter = Object.getOwnPropertyDescriptor(req, 'query').get;
  let processedQuery;

  // 重定义query的getter
  Object.defineProperty(req, 'query', {
    get() {
      if (!processedQuery) {
        const originalQuery = originalQueryGetter.call(req);
        // Joi验证转换
        const schema = Joi.object({
          inStock: Joi.boolean().truthy('1').falsy('0').default(false),
        });
        const { value } = schema.validate(originalQuery);
        processedQuery = value;
      }
      return processedQuery;
    },
    configurable: true // 允许后续修改该属性
  });

  next();
});

3. 折中兼容方案 #

如果不想修改全局配置或依赖内部实现，可以封装中间件，将验证后的结果挂载到自定义属性，同时兼容原req.query的使用方式：

const validateQuery = (schema) => (req, res, next) => {
  const { value, error } = schema.validate(req.query);
  if (error) {
    // 处理验证错误
    return res.status(400).send(error.details[0].message);
  }
  // 挂载验证后的结果
  req.validatedQuery = value;
  // 重定义req.query的getter，返回验证后的结果
  Object.defineProperty(req, 'query', {
    get() {
      return req.validatedQuery;
    },
    configurable: true
  });
  next();
};

// 使用示例
app.get('/products', validateQuery(Joi.object({
  inStock: Joi.boolean().truthy('1').falsy('0').default(false),
})), (req, res) => {
  console.log(req.query.inStock); // 直接使用处理后的结果
  res.send(req.query);
});

关于req.query不可写的原因推测 #

Express v5做这个改动，大概率是为了保持req.query与原始URL查询字符串的一致性——官方可能认为修改req.query会导致请求原始信息与处理后数据不一致，增加调试复杂度。而req.body是请求体解析的结果，本身就需要多次处理（解析、验证、转换）；params是路由匹配的结果，也可能需要根据业务调整，因此保留了它们的可写性。

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