遵循REST规则：按customerId查询项目用pathparam还是queryparam？

根据你提供的实体类关联关系（Customer与Project是一对多绑定），从REST资源设计的核心原则出发，通过customerId查询对应项目时，应该使用路径参数来设计API端点，具体原因如下：

• 贴合资源层级语义
  REST的核心是资源的层级化定位，Project是Customer的从属资源（每个项目都归属于特定客户）。用路径参数能清晰表达这种父子资源的归属关系，语义更直观明确。

  示例端点：

  GET /customers/{customerId}/projects
  

• 路径参数的定位属性匹配需求
  路径参数的作用是精准定位特定资源或资源集合，这里的{customerId}用来明确指定“某一客户名下的项目”，属于资源定位的核心部分。而查询参数更适合用于过滤、排序、分页这类对资源集合的二次筛选操作（比如按项目名称过滤时，才会用?projectName=xxx）。

• 匹配数据库模型逻辑
  从实体类的外键关联（Project通过customer_id绑定到Customer）来看，项目是客户的固有从属资源，路径参数的端点设计完全匹配这种数据库层面的关联逻辑，前后端交互的一致性更强。

不适合用查询参数的原因 #

如果设计成GET /projects?customerId=xxx，虽然功能上能实现，但违背了REST的资源语义——它将Project视为顶级资源，弱化了其与Customer的从属关系，语义清晰度远不如路径参数的设计方案。

符合规范的返回格式 #

你期望的返回格式完全符合REST规范，直接返回Project资源的JSON数组即可：

[
  {"id": "b793ca28-3732-408a-b661-d0542309f27d", "projectName": "Project A"},
  {"id": "35203977-c739-4033-ade0-142cac031977", "projectName": "Project B"}
]

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