Spring Controller如何通过点分隔参数名实现请求参数到DTO的映射

嗨，我之前也踩过这个坑！其实问题出在你用错了注解，Spring本身就支持这种带点分隔的参数映射到DTO，只是你不需要用@RequestParam来修饰DTO对象，我给你讲清楚怎么弄：

核心问题：别给DTO加@RequestParam #

你之前尝试给FilterDTO参数加@RequestParam注解，这就是导致属性全为null的原因！@RequestParam是用来绑定单个简单类型的请求参数（比如String、Integer），而复杂对象的参数绑定，Spring是靠它自带的数据绑定机制来处理的，根本不需要这个注解。

正确的实现方式 #

方法一：直接用DTO作为方法参数（最简单）

直接把FilterDTO作为Controller方法的参数，不用加任何注解，Spring会自动识别filter.name、filter.age这种带前缀的参数，把它们映射到DTO对象的对应属性上：

@GetMapping("/my/api")
List<MyResult> findAll(FilterDTO filter, Pageable page) {
    // 这里filter的name、age、active属性已经被正确赋值了
    // 你的业务逻辑代码
    return ...;
}

因为你用了Lombok的@Data注解，已经自动生成了getter和setter，Spring可以通过setter方法给DTO的属性赋值，完全不用额外配置。

方法二：用@InitBinder明确指定参数前缀（可选）

如果你担心方法参数名被混淆（比如和其他参数重名），可以在Controller里加一个@InitBinder方法，明确指定参数前缀和DTO的绑定关系：

@RestController
public class YourController {

    // 给FilterDTO类型的参数设置绑定前缀
    @InitBinder("filter")
    public void initFilterBinder(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("filter.");
    }

    @GetMapping("/my/api")
    List<MyResult> findAll(FilterDTO filter, Pageable page) {
        // 同样可以正常绑定参数
        return ...;
    }
}

这个方法的作用是告诉Spring：对于名为filter的方法参数，所有以filter.开头的请求参数，去掉前缀后再绑定到DTO的对应属性上，逻辑更清晰。

为什么之前的写法不行？ #

当你给FilterDTO加@RequestParam（不管带不带"filter"参数名），Spring会尝试找一个名为filter的单个请求参数，然后把它的值转换成FilterDTO对象，但你的请求里根本没有这个参数，只有filter.name、filter.age这种拆分的参数，所以自然无法绑定，所有属性都是null。

额外注意点 #

• 确保你的DTO类有对应的getter和setter方法（@Data已经帮你搞定了，不用手动写）
• Pageable参数可以和DTO参数一起正常使用，Spring会自动处理分页相关的请求参数（比如page、size、sort）

备注：内容来源于stack exchange，提问作者danieldestro