Spring Data JPA方法名查询如何兼容法语重音字符与基础字符？

这是个非常常见的场景——默认的findByNameContains这类方法名查询只会做精确字符匹配，没法同时匹配带重音的é和基础字符e。要实现**不区分重音（accent-insensitive）**的模糊查询，我们有几种靠谱的方案：

方案1：自定义JPQL查询，利用数据库的去重音函数 #

最直接的方式是在自定义查询里调用数据库原生的去重音函数，把字段值和输入参数都转成无重音的形式再做模糊匹配。不同数据库的函数略有差异，举几个常用的例子：

PostgreSQL（使用unaccent扩展） #

首先确保数据库已经安装了unaccent扩展，然后在Repository里定义自定义查询：

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {
    @Query("SELECT e FROM YourEntity e WHERE unaccent(e.name) LIKE unaccent(concat('%', :name, '%'))")
    List<YourEntity> findByNameWithAccentInsensitive(@Param("name") String name);
}

MySQL（利用字符集转换） #

MySQL可以通过转换字符集并指定不区分重音的排序规则来实现：

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {
    @Query(value = "SELECT * FROM your_entity WHERE CONVERT(name USING utf8) LIKE CONCAT('%', :name, '%') COLLATE utf8_general_ci", nativeQuery = true)
    List<YourEntity> findByNameWithAccentInsensitive(@Param("name") String name);
}

或者用utf8mb4_0900_ai_ci排序规则（MySQL 8.0+支持，更全面的不区分重音）。

SQL Server #

使用COLLATE指定不区分重音的排序规则：

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {
    @Query(value = "SELECT * FROM YourEntity WHERE name COLLATE SQL_Latin1_General_CP1_CI_AI LIKE CONCAT('%', :name, '%')", nativeQuery = true)
    List<YourEntity> findByNameWithAccentInsensitive(@Param("name") String name);
}

这种方案的好处是不需要修改实体结构，直接针对查询做处理，兼容性也不错。

方案2：配置字段的排序规则（Collation） #

如果希望所有针对这个字段的查询都默认不区分重音，可以在实体类的字段上指定排序规则，或者直接在数据库层面修改列的排序规则。

比如在实体类中：

@Column(name = "name", collation = "utf8mb4_0900_ai_ci") // MySQL 8.0+
// 或者PostgreSQL的"und-x-icu"搭配对应参数
private String name;

配置完成后，原来的findByNameContains(String name)方法就会自动忽略重音差异，同时匹配é和e的记录。

注意：不同数据库的排序规则名称不同，需要根据你使用的数据库版本选择合适的规则。

方案3：使用Hibernate的@Formula生成虚拟列 #

可以通过@Formula注解生成一个无重音的虚拟列，然后针对这个虚拟列做查询：

@Entity
public class YourEntity {
    @Id
    private Long id;
    
    private String name;
    
    @Formula("unaccent(name)") // PostgreSQL示例，其他数据库替换对应函数
    private String nameWithoutAccent;
    
    // getter和setter
}

然后在Repository里定义查询方法：

List<YourEntity> findByNameWithoutAccentContains(String name);

这种方案适合需要频繁做无重音查询的场景，虚拟列不会占用额外存储（除非你显式创建数据库层面的虚拟列）。

额外提示 #

如果需要动态构建查询（比如用Specification或Querydsl），也可以在查询条件中应用对应的去重音函数，逻辑和自定义JPQL一致。

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