Spring Data REST中JsonProperty带下划线导致排序失效问题排查

• 解析链路的配置割裂：Spring Data Rest 在解析排序参数、生成查询SQL的环节，完全不会读取Jackson的@JsonProperty注解配置。排序逻辑默认直接匹配JPA实体类的Java字段名，和你自定义的JSON序列化字段名没有任何联动关系。
• 下划线触发的默认误解析：内置的Sort参数解析器有个默认规则：当sort参数值中包含_或.时，会自动将其识别为嵌套属性的导航路径。比如传入的jj_aa、created_at，会被拆解为“查找jj属性下的aa字段”、“查找created属性下的at字段”，而非单个顶级字段名。当拆解后找不到对应的嵌套属性时，解析器会静默丢弃该条排序规则，既不抛出异常，也不会在最终生成的SQL里拼接对应的order by子句——这也是日志里看不到任何排序逻辑的直接原因。
  你之前的测试结果完全可以和这个逻辑对应上：
• 换成无下划线的jjaa作为sort参数时，解析器没有触发路径拆分，直接把整个值当顶级字段名匹配实体属性，排序逻辑正常生效
• 改回带下划线的自定义字段名时，解析器触发拆分逻辑，找不到对应的嵌套路径，直接把排序规则丢了

完全不需要改动现有JSON输出的下划线命名规则，两种方案可以根据团队情况选择：

1. 最小改动方案（零代码侵入）
   Spring Data Rest的sort参数，本质上永远是用来匹配实体类的Java属性路径，而非对外输出的JSON字段名。直接调整前端的sort参数传值规则即可：
   把原来的请求地址：

   http://localhost:8080/simple-users?page=0&size=10&sort=created_at,desc
   

   替换为传实体侧的驼峰字段名：

   http://localhost:8080/simple-users?page=0&size=10&sort=createdAt,desc
   

   这种方式不会改动任何现有接口的返回结构（接口输出的JSON字段依然保持created_at的蛇形命名），仅需要前端在构造排序参数时，把目标字段替换为对应实体的Java驼峰名即可，前后端现有代码的改动量极低，基本没有重构成本。
2. 兼容现有传参方案（零前端改动）
   如果不想调整前端的传参逻辑，可以通过实现RepositoryRestConfigurer自定义排序参数解析器，将默认的属性命名匹配策略调整为蛇形映射规则，让解析器自动把created_at这类带下划线的sort参数，映射到实体对应的驼峰字段createdAt，同时取消将下划线识别为嵌套路径分隔符的默认逻辑。配置完成后，前端现有的传参规则可以完全保持不变，排序逻辑即可正常生效。

常见认知误区纠正：@JsonProperty的配置仅作用于Jackson的JSON序列化、反序列化环节，负责把实体字段和JSON报文的字段做映射，和Spring Data Rest内部的查询、排序、过滤参数解析链路是完全独立的，不会自动联动生效。

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