在 Spring Boot 项目中，带有 Query 后缀的查询对象通常属于请求参数或数据传输层，推荐将其放置在以下位置之一：
推荐目录结构
src└── main└── java└── com└── example├── controller├── dto # ✅ 推荐，DTO/Query 对象统一管理│ ├── request # ✅ 查询对象 (UserQuery, OrderSearchRequest)│ ├── response # ✅ 响应对象 (UserDTO, OrderDetailDTO)│ └── common # 可选：通用DTO├── entity├── mapper├── service└── util
最佳实践说明
✅ dto/request ➔ 放置查询参数对象 (UserQuery)，明确标识为请求数据
✅ dto/response ➔ 放置响应数据对象 (UserDTO)，区分不同数据流向
✅ dto/common ➔ 放置通用数据对象（如 PageInfoDTO、ResultDTO 等）
示例代码
UserQuery.java（放在 dto/request 文件夹）
package com.example.dto.request;import lombok.Data;@Data
public class UserQuery {private String username;private String email;private Integer age;
}
UserDTO.java（放在 dto/response 文件夹）
package com.example.dto.response;import lombok.Data;@Data
public class UserDTO {private String username;private String email;private String roleName;
}
🚨 为什么推荐这种结构？
✅ 清晰的职责分离：将查询、返回、通用数据分类，项目结构更直观。
✅ 易于维护：项目扩展时，新增 DTO 类更有条理。
✅ 符合主流实践：Spring Boot 项目中较为常见的目录规范。
这种方法更利于项目的长期维护，尤其是当项目规模扩大时，目录清晰度会大幅提升。