Vue+Express环境下REST API筛选请求路由格式是否为反模式？

关于你的核心疑问 #

GET https://example.com/api/v1/cities?country={countryId} 这种写法完全不属于API反模式，是REST架构中处理集合筛选的标准方式之一。

REST规范里，URL的路径部分用来标识资源（比如/api/v1/cities代表城市集合资源），而查询参数（?后面的部分）就是用来做筛选、排序、分页这类非资源标识的操作。用country作为筛选参数，语义清晰，后端可以直接解析该参数过滤出对应国家的城市列表，完全符合REST的设计原则。

关于同事提出的?country.id={countryId}格式 #

这种写法也没问题，属于更细化的参数命名风格，通常适用于以下场景：

• 当需要针对关联对象的多个属性做筛选时，比如同时按国家ID和名称筛选：?country.id=123&country.name=China，这种结构能让参数的归属关系更明确
• 团队内部有统一的参数命名规范，要求明确关联对象的属性

但如果只是单纯按国家ID筛选，country={countryId}的写法更简洁，没必要过度复杂化参数结构。

Node Express后端处理示例 #

不管用哪种参数格式，Express都能通过req.query轻松获取参数：

app.get('/api/v1/cities', (req, res) => {
  // 兼容两种参数格式
  const countryId = req.query.country || req.query['country.id'];
  let filter = {};
  if (countryId) {
    filter.countryId = countryId;
  }
  // 执行数据库查询逻辑
  City.find(filter)
    .then(cities => res.status(200).json(cities))
    .catch(err => res.status(500).json({ error: err.message }));
});

总结 #

两种写法都合规，选择哪种主要看团队的API规范：

• 追求简洁高效：用?country={countryId}，适合单一筛选条件的场景
• 追求扩展性和语义精准：用?country.id={countryId}，适合未来可能添加更多关联属性筛选的场景

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