Spring Data Repository：findById与自定义派生查询的差异（含复合主键）

一、单主键场景：findById(key) vs findByKey(String key) #

假设实体类定义如下：

@Entity
class SomeEntity {
    @Id
    private String key;
    // 其他字段与方法
}

两者核心差异如下：

• 方法来源与通用性：findById是CrudRepository提供的通用规范方法，不依赖实体主键的具体字段名，只要实体有主键就能直接使用；findByKey是基于Spring Data JPA查询推导规则自定义的方法，完全依赖主键字段名key，若后续主键字段改名，必须同步修改方法名。
• 返回值灵活性：findById固定返回Optional<SomeEntity>，通过Optional统一处理“找不到数据”的场景；findByKey可自定义返回类型——既可以返回Optional<SomeEntity>，也可以直接返回SomeEntity（数据不存在时会抛出NoSuchElementException）。
• 底层查询逻辑：两者生成的SQL完全一致（均为SELECT ... FROM some_entity WHERE key = ?），且都会优先命中主键索引，性能上无差异。

二、复合主键场景：findById(new CompositeKey(...)) vs findByFirstKeyAndSecondKey(int firstKey, String secondKey) #

假设实体类与复合主键定义如下：

class CompositeKey implements Serializable {
    private Integer firstKey;
    private String secondKey;
    // 构造方法、equals与hashCode实现
}

@Entity
@IdClass(CompositeKey.class)
class SomeEntity {
    @Id
    private Integer firstKey;
    @Id
    private String secondKey;
    // 其他字段与方法
}

两者差异主要体现在：

• 参数传递方式：findById必须传入构造好的CompositeKey对象，需要提前组装主键字段；findByFirstKeyAndSecondKey直接接收两个独立参数，无需额外创建主键对象，使用更灵活。
• 方法通用性：findById依然是通用方法，不管复合主键包含多少字段，都可使用同一方法查询；自定义的findByFirstKeyAndSecondKey依赖于复合主键的具体字段名，字段增减或改名时必须同步修改方法名。
• 返回值规则：与单主键场景一致，findById固定返回Optional<SomeEntity>；自定义方法可选择返回Optional<SomeEntity>或直接返回SomeEntity（无数据时抛异常）。
• 缓存与底层优化：findById作为JPA规范定义的主键检索方法，框架会针对主键查询做专门的缓存优化（比如一级缓存的直接命中）；自定义组合查询虽生成的SQL相同，但在缓存匹配逻辑上可能存在细微差异，日常业务场景下该差异几乎可忽略。

总结 #

两种查询方式的核心SQL逻辑基本一致，但在方法通用性、使用便捷性、返回值灵活性上存在差异。若追求代码通用性和规范统一，优先使用findById；若追求使用便捷性（无需构造主键对象），可选择自定义查询方法。

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