跳到主要内容

从 5.2.x 升级到 5.3.x

DeepSeek V3 中英对照 Upgrading from 5.2.x to 5.3.x

本节描述了从版本 5.2.x 到 5.3.x 的重大变更,以及如何通过新引入的功能替换已移除的功能。

重大变更

@Query 注解的仓库方法中进行参数替换时,之前的版本会在实际参数值为 null 时,将字符串 "null" 写入发送到 Elasticsearch 的查询中。由于 Elasticsearch 不存储 null 值,这种行为可能会导致问题,例如当要搜索的字段包含字符串 "null" 时。在 5.3 版本中,参数中的 null 值将导致抛出 ConversionException。如果你在字段映射中定义了 "null" 作为 null_value,那么请将该字符串传递给查询,而不是传递 Java 的 null

弃用

移除

已弃用的类 org.springframework.data.elasticsearch.ELCQueriesorg.springframework.data.elasticsearch.client.elc.QueryBuilders 已被移除,请改用 org.springframework.data.elasticsearch.client.elc.Queries