Spring Controller用dot notation绑定嵌套对象参数报Bad Request

你对Spring参数绑定的点表示法适用场景理解有误：

• Spring 4+ 原生支持的点表示法参数绑定，仅针对POJO内部的嵌套对象属性：比如DTO中存在private User user;这类嵌套对象字段时，请求参数用user.name=zhangsan可以绑定到user对象的name属性，但该规则不支持直接给顶层绑定的POJO加自定义前缀。
• 你当前直接将JhmPageableDto作为Controller方法的入参，没有额外配置的前提下，Spring只会匹配和DTO字段名完全一致的请求参数（即page/size/sort这类不带p.前缀的参数）。你实际传递的所有参数都带p.前缀，无法匹配到对应字段，且page/size是基本类型int，绑定失败时会直接抛出参数缺失/类型转换异常，最终返回400 Bad Request。
• 单独添加@RequestParam("p.page") int page可以正常接收，是因为@RequestParam显式指定了参数名，走的是单独参数绑定逻辑，和POJO对象绑定逻辑完全独立，不能作为POJO绑定逻辑正常的依据。

任选其一即可：

方案1：通过@InitBinder指定参数前缀（改动最小） #

在对应Controller中添加数据绑定初始化方法，指定该DTO对应的参数前缀：

@InitBinder("p") // 注解内的值必须和Controller方法中DTO的形参名一致
public void initPageableParamBinder(WebDataBinder binder) {
    binder.setFieldDefaultPrefix("p."); // 识别所有带p.前缀的参数绑定到该对象
}

添加后原有Controller方法写法无需修改，保持public 返回值 方法名(JhmPageableDto p)即可，Spring会自动将p.page/p.size等参数映射到DTO对应字段。

方案2：移除请求参数的p.前缀 #

如果业务没有强制要求参数带p.前缀，直接将请求参数改为page=1&size=10&sort=xxx这类无前缀的形式，Spring会自动完成同名参数和顶层POJO字段的绑定，无需额外配置。

方案3：定义前缀包装类，复用原生嵌套绑定逻辑 #

如果不想加@InitBinder配置，可以定义一层包装类，将原有DTO作为包装类的内部字段，字段名设为p：

public class PageableRequest {
    private JhmPageableDto p;

    public JhmPageableDto getP() {
        return p;
    }

    public void setP(JhmPageableDto p) {
        this.p = p;
    }
}

将Controller方法入参改为该包装类：public 返回值 方法名(PageableRequest req)，此时原有的p.xxx参数会被Spring识别为嵌套对象属性，自动完成绑定。

如果调整后仍出现400错误，检查参数值的类型合法性：page/size为int类型，不要传递非数字值；sortAsc为boolean类型，仅支持传true/false、1/0这类可转换为布尔值的内容，非法值会触发类型转换异常导致请求失败。

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