---

Spring Data JPA 的 方法名派生查询（Query Derivation） 是其核心特性之一，允许开发者通过简单的方法命名规则自动生成 SQL 查询，而无需手动编写 SQL 或 JPQL。以下是其实现原理和关键机制：

---

一、方法名解析规则

Spring Data JPA 通过解析方法名中的 关键字 和 属性名，自动推导出查询逻辑。例如：

// 示例方法名
List<User> findByNameContaining(String namePart);

1. 方法名结构

方法名部分	作用
findBy	查询的入口（其他前缀如 countBy、deleteBy 等）。
Name	实体类的属性名（对应数据库字段 name）。
Containing	查询条件关键字（生成 LIKE %namePart%）。

2. 常见关键字

关键字	生成的 SQL 条件	示例方法名
Containing	LIKE %value%	findByNameContaining(String name)
StartingWith	LIKE value%	findByNameStartingWith(String name)
EndingWith	LIKE %value	findByNameEndingWith(String name)
GreaterThan	> value	findByAgeGreaterThan(int age)
LessThan	< value	findByPriceLessThan(double price)
IsNull/IsNotNull	IS NULL 或 IS NOT NULL	findByEmailIsNull()

---

二、底层实现机制

1. 动态代理（Repository Proxy）

• 接口代理生成：Spring Data JPA 在启动时为每个 Repository 接口生成动态代理类。
• 方法拦截：当调用 findByNameContaining 时，代理类会拦截方法名，解析其语义，并生成对应的 SQL 或 JPQL。

2. 元数据解析

• 方法名分词：将方法名按驼峰规则拆分为 find、By、Name、Containing。
• 属性映射：通过反射获取实体类 User 的属性 name，并映射到数据库字段（默认按驼峰转下划线，如 user_name 可通过 @Column 自定义）。

3. 查询生成

• 条件组合：根据关键字 Containing 生成 WHERE name LIKE %?%。
• 参数绑定：将方法参数 namePart 绑定到 SQL 参数占位符。

---

三、代码示例

1. 实体类定义

@Entity
public class User {@Id@GeneratedValueprivate Long id;private String name;// Getters and Setters
}

2. Repository 接口

public interface UserRepository extends JpaRepository<User, Long> {List<User> findByNameContaining(String namePart);
}

3. 生成的 SQL

SELECT * FROM user WHERE name LIKE '%namePart%';

---

四、适用场景与限制

1. 适用场景

• 简单查询：单表条件查询、排序、分页。
• 快速开发：减少样板代码，提升开发效率。

2. 限制

• 复杂查询：涉及多表关联、复杂聚合函数时，需用 @Query 手动编写 JPQL。
• 命名约束：方法名必须严格遵循规则，否则解析失败（如拼写错误 findByNmae）。

---

五、扩展：自定义查询

对于复杂场景，可通过 @Query 注解直接编写 JPQL 或 SQL：

public interface UserRepository extends JpaRepository<User, Long> {@Query("SELECT u FROM User u WHERE u.name LIKE %:name% AND u.age > :age")List<User> findByNameAndAge(@Param("name") String name, @Param("age") int age);
}

---

总结

• 方法名派生查询是 Spring Data JPA 的核心特性，通过解析方法名中的关键字和属性名，自动生成 SQL。
• 适用简单查询：快速实现条件过滤、排序、分页。
• 复杂查询：需结合 @Query 或 Specification 实现。

这种机制通过约定大于配置，显著提升了开发效率，是 Spring Data JPA 广受欢迎的重要原因之一。