Spring Data JPA如何在SPEL表达式中传递实体属性作为函数参数？

首先明确：你当前的写法行不通，而且这种思路存在性能致命问题——SPEL表达式是在Spring上下文层面执行的，而非数据库层面，没法直接接收JPQL里的实体属性作为参数。强行这么写要么语法报错，要么导致全表扫描（Spring会先加载所有Person数据到内存，再逐个用SPEL处理过滤）。

正确的两种解决思路 #

方案一：使用数据库层面的函数（推荐）

把电话号码标准化逻辑迁移到数据库端（自定义函数或用内置函数拼接），直接在JPQL中调用数据库函数处理实体属性，这样查询可以利用数据库索引，性能最优。

比如你在数据库中创建了和PhoneUtils.normalizePhoneNumber逻辑一致的自定义函数，那么仓库方法可以写成：

interface PersonRepository: JpaRepository<Person, String> {
    @Query(value = "SELECT p FROM Person p WHERE normalizePhoneNumber(p.phoneNumber) IN :phoneNumbers")
    fun getPersonsByPhoneNumbers(phoneNumbers: Set<String>): List<Person>
}

如果不想自定义数据库函数，也可以用数据库内置的字符串处理函数（比如REPLACE、REGEXP_REPLACE等）直接在JPQL里实现标准化逻辑，比如去掉非数字字符、补全国区号等。

方案二：在实体中维护标准化字段（最稳妥）

在Person实体中新增一个存储标准化后电话号码的字段，在插入或更新数据时自动调用PhoneUtils.normalizePhoneNumber赋值：

@Entity
data class Person(
    @Id val id: String,
    val phoneNumber: String,
    val normalizedPhoneNumber: String // 存储E.164格式的标准化号码
)

之后仓库方法可以直接用Spring Data JPA的派生查询，无需手写@Query：

interface PersonRepository: JpaRepository<Person, String> {
    fun findByNormalizedPhoneNumberIn(phoneNumbers: Set<String>): List<Person>
}

这种方式查询效率最高，因为可以给normalizedPhoneNumber字段创建索引，完全利用数据库的查询优化。

为什么原写法不可行 #

SPEL的:#T()语法是用来在Spring上下文里调用Java/Kotlin类的静态方法，但它的执行时机是在Spring解析JPQL语句的时候，此时JPQL中的p.phoneNumber还只是一个抽象的实体属性标识，并没有实际的数值，SPEL无法获取到这个值。就算Spring强行兼容这种写法，也只能先把所有Person数据加载到内存，再逐个调用PhoneUtils.normalizePhoneNumber过滤，这在数据量较大时会直接导致性能灾难。

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