如何在URI中以查询参数传递对象？及@RequestParam使用合理性咨询

针对你提出的两个问题，我来结合Spring Boot的使用规范和你的代码场景逐一解答：

一、如何在URI查询参数中传递对象？ #

在Spring体系中，通过查询参数传递复杂对象的核心方式是把对象的属性拆分为带前缀的查询参数，让Spring自动完成参数到对象的绑定。

举个例子，你的Author类有name、dateOfBirth这些属性，请求URL可以写成：

/search?author.name=J.K.Rowling&author.dateOfBirth=1965-07-31

Spring会自动识别author.前缀，把对应的值映射到Author对象的同名属性上。

二、用@RequestParam接收Author对象是否合理？ #

直接用@RequestParam接收Author类型的参数并不合理，原因有两个：

1. 设计定位不符：@RequestParam是为接收单个简单类型参数（比如String、Integer）设计的，用来接收复杂对象不符合Spring MVC的设计规范，可读性差，后续维护也容易踩坑。
2. 绑定会失败：你的Author类只加了@Getter注解，没有@Setter，Spring无法通过反射为对象的属性赋值，最终会得到一个所有属性都是null的空对象，完全无法满足你的业务需求。

正确的做法：使用@ModelAttribute接收 #

修改你的控制器方法参数，把@RequestParam换成@ModelAttribute（甚至可以省略这个注解，Spring会默认对复杂类型参数应用@ModelAttribute）：

@GetMapping(value = "/search")
public ResponseEntity<List<Book>> searchBooksByTitleAndAuthor(
        @RequestParam(value = "title", required = false) final String title,
        // 替换为@ModelAttribute，或者直接写Author author即可
        @ModelAttribute(value = "author", required = false) final Author author) {
    // 原有业务逻辑保持不变
}

同时，给Author类添加@Setter注解（或者手动编写所有属性的setter方法），这样Spring才能成功绑定参数：

@Entity
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter // 新增Setter注解
@EqualsAndHashCode
@ToString
public final class Author {
    @Id
    @GeneratedValue(strategy=GenerationType.IDENTITY)
    private Long id;
    private String name;
    private LocalDate dateOfBirth;
    private String bio;
}

三、关于服务层方法的兼容问题 #

你提到“只传递作者名字字符串会影响服务层方法实现”，其实可以用两种方式兼顾：

1. 直接传递绑定后的Author对象：如果服务层方法原本就接受Author参数，那绑定后的Author对象（哪怕只有name属性有值）可以直接传入，服务层内部可以根据name字段去查询对应的作者信息，无需修改核心逻辑。
2. 控制器层封装对象：如果觉得带前缀的URL不够简洁，也可以单独接收authorName参数，再手动封装成Author对象传给服务层，这样既不改动服务层，URL也更友好：

@GetMapping(value = "/search")
public ResponseEntity<List<Book>> searchBooksByTitleAndAuthor(
        @RequestParam(value = "title", required = false) final String title,
        @RequestParam(value = "authorName", required = false) final String authorName) {
    Author author = null;
    if (authorName != null) {
        author = new Author();
        author.setName(authorName);
    }
    // 后续调用bookService的逻辑完全不变
}

这种方式的URL会变成/search?authorName=J.K.Rowling，更简洁直观。

总结一下 #

• 查询参数传递对象：用对象.属性格式传参，搭配@ModelAttribute接收。
• 避免用@RequestParam接收复杂对象，不符合框架规范还容易绑定失败。
• 服务层兼容：要么直接传绑定后的对象，要么在控制器层封装对象，都能保证服务层逻辑不受影响。

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