JPA方法无法生成含OR分支代码为空的关联查询求助

1. 修正实体类的关联配置 #

你的TrainingMaster类中的@OneToOne关联配置存在错误，直接导致JPA生成的关联逻辑不符合预期：

错误点说明： #

• @JoinColumn参数写反：name应指定关联表（TblBranchTraining）的外键列名（即training_id），referencedColumnName指定当前实体（TrainingMaster）的主键列名（即id）
• nullable=false强制要求每个TrainingMaster必须关联TblBranchTraining，与你需要的left join逻辑冲突（left join允许无关联的分支培训记录）
• TblBranchTraining中的trainingId属于冗余字段，JPA会通过关联注解自动维护外键，手动保留易引发数据不一致

修正后的实体类： #

TrainingMaster.java

public class TrainingMaster implements Serializable{

    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    
    @Column(name="training_name")
    private String trainingName;
    
    // 修正关联配置，允许空关联以适配left join逻辑
    @OneToOne(cascade= CascadeType.ALL)
    @JoinColumn(name = "training_id", referencedColumnName = "id")
    private TblBranchTraining branchTraining;
}

TblBranchTraining.java

public class TblBranchTraining implements Serializable{
    
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    
    // 移除冗余的trainingId字段，由JPA关联注解维护外键
    
    private String status;
    
    private String date;
        
    @Column(name = "branch_code")
    private String branchCode;
}

2. 编写正确的Repository查询方法 #

JPA方法命名规则无法生成包含OR ... IS NULL的复杂条件，需使用@Query自定义查询：

方式一：JPQL查询（推荐，与实体类绑定，适配多数据库） #

@Repository
public interface TrainingMasterRepository extends JpaRepository<TrainingMaster, Integer> {

    @Query("SELECT tm FROM TrainingMaster tm LEFT JOIN tm.branchTraining tb " +
           "WHERE tb.branchCode = :branchCode OR tb IS NULL")
    List<TrainingMaster> findByBranchCodeOrUnassigned(String branchCode);
}

方式二：原生SQL查询（直接使用表名列名，适合复杂SQL场景） #

如果偏好使用你最初写的原生SQL，可按如下方式配置：

@Repository
public interface TrainingMasterRepository extends JpaRepository<TrainingMaster, Integer> {

    @Query(value = "SELECT tm.*, tb.* " +
                   "FROM TrainingMaster tm LEFT JOIN TblBranchTraining tb ON tm.id = tb.training_id " +
                   "WHERE (tb.branch_code = :branchCode OR tb.branch_code IS NULL)",
           nativeQuery = true)
    List<TrainingMaster> findByBranchCodeOrUnassigned(String branchCode);
}

3. 原查询异常原因 #

你最初的SQL逻辑本身正确，但因实体类关联配置错误，JPA生成的关联条件与手动SQL不匹配，导致过滤逻辑失效。修正关联配置后，上述自定义查询可正确返回两类记录：

• 关联的TblBranchTraining中branchCode匹配指定值的TrainingMaster
• 未关联任何TblBranchTraining的TrainingMaster（对应tb IS NULL场景）

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