Spring JDBC多表关联查询仅返回单表数据问题求助

问题根源 #

1. 实体类结构缺失：你的User类未定义vehicle和home集合属性，即便SQL查询到关联数据，也没有存储载体。
2. RowMapper未处理关联字段：当前UserRowMapper仅映射User自身字段，完全忽略vehicle和home的查询结果。
3. SQL关联逻辑限制：使用INNER JOIN会过滤掉无对应vehicle或home的用户，且未指定字段别名，可能引发字段冲突。

解决步骤 #

1. 调整实体类结构

补充Vehicle、Home实体类，并给User添加对应集合属性：

// Vehicle实体类
public class Vehicle {
    private String make;
    private String model;
    
    // 构造器、Getter、Setter（或用Lombok的@Data注解简化）
}

// Home实体类
public class Home {
    private String type;
    
    // 构造器、Getter、Setter（或用Lombok的@Data注解简化）
}

// 修改后的User实体类
public class User {
    private int id;
    private String firstName;
    private String lastName;
    private String email;
    private List<Vehicle> vehicles;
    private List<Home> homes;
    
    // 构造器、Getter、Setter（或用Lombok的@Data注解简化）
}

2. 修改SQL查询语句

用LEFT JOIN确保无关联数据的用户也能返回，同时指定字段别名避免冲突：

SELECT 
    u.id AS user_id,
    u.first_name,
    u.last_name,
    u.email,
    v.make,
    v.model,
    h.type AS home_type
FROM user u
LEFT JOIN vehicle v ON u.id = v.userId
LEFT JOIN home h ON u.id = h.userId
WHERE u.id = ?

3. 实现结果集合并逻辑

多表关联会产生笛卡尔积（同一用户对应多条关联数据），推荐用ResultSetExtractor处理整个结果集，合并重复用户并填充关联集合：

@Override
public User getAllUserData(int id) {
    String sql = """
        SELECT 
            u.id AS user_id,
            u.first_name,
            u.last_name,
            u.email,
            v.make,
            v.model,
            h.type AS home_type
        FROM user u
        LEFT JOIN vehicle v ON u.id = v.userId
        LEFT JOIN home h ON u.id = h.userId
        WHERE u.id = ?
        """;
    
    return jdbcTemplate.query(sql, rs -> {
        User user = null;
        List<Vehicle> vehicles = new ArrayList<>();
        List<Home> homes = new ArrayList<>();
        
        while (rs.next()) {
            if (user == null) {
                // 初始化用户基础信息
                user = new User();
                user.setId(rs.getInt("user_id"));
                user.setFirstName(rs.getNString("first_name"));
                user.setLastName(rs.getNString("last_name"));
                user.setEmail(rs.getNString("email"));
            }
            
            // 处理车辆数据，空值判断避免添加无效数据
            String make = rs.getNString("make");
            if (make != null) {
                Vehicle vehicle = new Vehicle(make, rs.getNString("model"));
                if (!vehicles.contains(vehicle)) {
                    vehicles.add(vehicle);
                }
            }
            
            // 处理住址数据，空值判断避免添加无效数据
            String homeType = rs.getNString("home_type");
            if (homeType != null) {
                Home home = new Home(homeType);
                if (!homes.contains(home)) {
                    homes.add(home);
                }
            }
        }
        
        if (user != null) {
            user.setVehicles(vehicles);
            user.setHomes(homes);
        }
        return user;
    }, id);
}

4. 序列化校验

确保User、Vehicle、Home类的Getter方法齐全（或使用Lombok注解），否则JSON序列化时无法输出集合属性。

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