Spring Boot单次DB查询获取多实体，无数据对应字段返回null

一、先修正现有实体与Repository的问题 #

在合并查询前，需先修复代码中的基础错误，确保JPA能正确处理表关联：

1. 修正实体类的关联注解
   原TabletEntity和LaptopEntity中userId字段的注解不符合JPA规范，应使用@ManyToOne关联UserData：

@Entity
@Table(name ="TABLET_DATA")
public class TabletEntity {
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; // 改为Long类型适配IDENTITY自增策略

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "USER_ID", referencedColumnName = "USER_ID", nullable = false)
    private UserData user;

    @Column(name = "PRODUCT_NAME")
    private String productName;

    // Getter、Setter
    // 可选：添加直接获取userId的方法，简化后续查询
    public Long getUserId() {
        return user.getUserId();
    }
}

LaptopEntity做同样修改。

2. 修正Repository泛型定义
   原Repository泛型参数缺失，需明确实体类和ID类型：

@Repository
public interface TabletRepository extends JpaRepository<TabletEntity, Long> {
    TabletEntity findByUser_UserId(Long userId);
}

LaptopRepository同理。

二、合并查询的具体实现方案 #

方案1：JPQL左连接查询（推荐）

通过左连接一次性关联三张表，确保无对应数据时返回null，仅触发一次数据库查询。在UserDataRepository中添加自定义查询方法：

1. 定义UserDataRepository

@Repository
public interface UserDataRepository extends JpaRepository<UserData, Long> {
    @Query("SELECT u.userName, t.productName, l.productName " +
           "FROM UserData u " +
           "LEFT JOIN TabletEntity t ON u.userId = t.user.userId " +
           "LEFT JOIN LaptopEntity l ON u.userId = l.user.userId " +
           "WHERE u.userId = :userId")
    Object[] findUserWithDevices(@Param("userId") Long userId);
}

2. 修改Service类

@Service
public class DataService {
    @Autowired
    private UserDataRepository userDataRepository;

    public ServiceBean fetchData(Long userId) {
        Object[] result = userDataRepository.findUserWithDevices(userId);
        ServiceBean bean = new ServiceBean();
        if (result != null) {
            // 索引1为平板名称，索引2为笔记本名称，无数据则为null
            bean.setTabletName((String) result[1]);
            bean.setLaptopName((String) result[2]);
        }
        return bean;
    }
}

方案2：自定义DTO投影（更优雅）

定义DTO类让JPQL直接映射结果，避免数组索引操作：

1. 创建DTO类

public class UserDeviceDTO {
    private String userName;
    private String tabletName;
    private String laptopName;

    // 构造方法需与JPQL查询字段顺序完全一致
    public UserDeviceDTO(String userName, String tabletName, String laptopName) {
        this.userName = userName;
        this.tabletName = tabletName;
        this.laptopName = laptopName;
    }

    // Getter、Setter
}

2. 修改Repository查询

@Repository
public interface UserDataRepository extends JpaRepository<UserData, Long> {
    @Query("SELECT new com.yourpackage.UserDeviceDTO(u.userName, t.productName, l.productName) " +
           "FROM UserData u " +
           "LEFT JOIN TabletEntity t ON u.userId = t.user.userId " +
           "LEFT JOIN LaptopEntity l ON u.userId = l.user.userId " +
           "WHERE u.userId = :userId")
    UserDeviceDTO findUserDeviceDTO(@Param("userId") Long userId);
}

3. 简化Service逻辑

@Service
public class DataService {
    @Autowired
    private UserDataRepository userDataRepository;

    public ServiceBean fetchData(Long userId) {
        UserDeviceDTO dto = userDataRepository.findUserDeviceDTO(userId);
        ServiceBean bean = new ServiceBean();
        if (dto != null) {
            bean.setTabletName(dto.getTabletName());
            bean.setLaptopName(dto.getLaptopName());
        }
        return bean;
    }
}

方案3：原生SQL查询

若更偏好原生SQL，可使用以下方式：

@Repository
public interface UserDataRepository extends JpaRepository<UserData, Long> {
    @Query(value = "SELECT u.USER_NAME, t.PRODUCT_NAME, l.PRODUCT_NAME " +
                   "FROM USER_DATA u " +
                   "LEFT JOIN TABLET_DATA t ON u.USER_ID = t.USER_ID " +
                   "LEFT JOIN LAPTOP_DATA l ON u.USER_ID = l.USER_ID " +
                   "WHERE u.USER_ID = :userId", nativeQuery = true)
    Object[] findUserWithDevicesNative(@Param("userId") Long userId);
}

Service层处理逻辑与方案1一致。

三、关键说明 #

• **左连接（LEFT JOIN）**是核心：即使某张表无用户对应数据，仍会返回该行，对应字段为null，完全匹配需求。
• 所有方案均仅触发一次数据库查询，避免了多次SELECT的性能损耗。
• 无需合并原有表结构，保留了三张表的独立性。

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