Spring JPA派生查询因关联实体ID Getter方法失效问题求助

实体类代码 #

Post实体 #

@Entity
public class Post{
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public Long id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id")
    private User user;
}

User实体 #

@Entity
public class User{
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public Long id;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private List<Post> posts= new ArrayList<>();
}

仓库接口代码 #

@Repository
public interface PostRepository extends JpaRepository<Post, Long> {
  List<Post> findAllByUserId(Long id);
}

问题描述 #

原本上述代码均可正常运行，但为Post类添加以下获取关联User ID的方法后，findAllByUserId方法停止工作，抛出IllegalArgumentException: Unable to locate Attribute with the given name UserId：

public Long getUserId(){
    return user== null ? null : user.getId();
}

希望解决该错误，或找到更便捷的获取关联实体ID的方式。

已尝试的方案 #

• 为getUserId方法添加@Transient注解，无效；
• 知晓可使用findAllByUser(User user)方法，但希望通过ID获取实体；
• 知晓可使用@Query注解，但写法过于冗长；
• 目前仅发现重命名方法（如改为_getUserId）可解决，但想了解其他方法。

解决方案 #

原因分析 #

Spring Data JPA的查询方法命名规则会自动解析方法名中的属性路径：当你添加getUserId()方法后，JPA会将其推断为Post实体的一个名为userId的属性，而非关联User实体的id属性。因此解析findAllByUserId时，会直接在Post实体中查找userId字段，找不到就抛出异常。

可行解决方法 #

1. 修改方法名避免属性推断冲突
   将getUserId()改为不会被JPA识别为实体属性的命名，比如getUserIdentifier()、fetchAssociatedUserId()等。这样JPA就不会把该方法对应为Post的属性，findAllByUserId会正常解析为关联User的id属性。

2. 指定实体的属性访问类型
   在Post类上添加@Access(AccessType.FIELD)注解，强制JPA通过字段而非getter方法来识别实体属性：

   @Entity
   @Access(AccessType.FIELD)
   public class Post{
       // 原有字段代码...
       
       public Long getUserId(){
           return user == null ? null : user.getId();
       }
   }
   

   此配置下JPA会忽略getter方法的属性推断，仅依据实体字段解析查询方法，findAllByUserId即可正常工作。

3. 显式指定JPQL查询（简化版）
   若不想修改方法名，可使用@Query注解显式定义查询逻辑，写法可尽量简洁：

   @Repository
   public interface PostRepository extends JpaRepository<Post, Long> {
       @Query("SELECT p FROM Post p WHERE p.user.id = ?1")
       List<Post> findAllByUserId(Long id);
   }
   

   虽然比命名查询稍长，但能直接规避方法名解析冲突。

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