Spring Boot中Repository方法名错误致应用启动失败求助

云上老周

2026-7-25

Spring Data JPA 报错：No property 'id' found for type 'Room' 排查方案

问题场景

在开发预订应用时，RoomRepository中定义了如下方法：

Optional<Room> findByIdAndStatus(int id, Status status);

启动Spring Boot应用时触发报错，错误信息如下：

Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled....No property 'id' found for type 'Room' Did you mean ''tip''

排查修复步骤

核对Room实体的主键字段命名
Spring Data JPA默认通过id字段（或带@Id注解的字段）识别主键。如果你的Room实体主键字段不是id（比如叫roomId、rid），就会触发这个错误。
错误示例（实体字段不匹配）：
```
@Entity
public class Room {
    @Id
    private Integer roomId; // 字段名不是id，导致findById...方法无法识别
    private Status status;
    // 其他字段、getter/setter
}
```
修复：要么把实体字段名改成id，要么修改Repository方法名匹配实际字段，比如findByRoomIdAndStatus。
检查字段的getter方法命名
Spring Data JPA依赖getter方法识别属性，哪怕字段名是id，如果getter方法是getRoomId()这类错误命名，框架也识别不了id属性。
错误示例：
```
public Integer getRoomId() { // 字段是id，但getter命名错误
    return this.id;
}
```
修复：确保getter方法为getId()，和字段名id对应。
排查拼写/大小写问题
Java是大小写敏感的，比如实体字段是Id（大写I），但方法里用的是id（小写i），也会导致识别失败。必须保证方法中的id和实体字段的拼写、大小写完全一致。
关注错误提示的'tip'线索
错误信息提到Did you mean ''tip''，说明框架在实体中找到了tip属性却没找到id。仔细检查Room实体，确认是否把id字段误写成了tip，或者存在其他拼写错误。
确认实体注解配置
确保Room类标注了@Entity注解，主键字段标注了@Id注解，遗漏这些注解会导致框架无法正确解析实体结构。