Spring Repository：SELECT查询如何取关联表冗余列而非主表列

问题背景 #

原绑定Spring JPA实体类的查询：

select *
from items item

现在需要关联item_state表并扩展查询，需求SQL大致如下：

select item.*, is.id
from items item
inner join item_state itm_s where item.id=itm_s.id

但items和item_state表都存在code字段，需要取item_state的code而非items的，且items表字段近百个，不想逐个枚举字段，也不想修改原实体类。

可行方案 #

1. SQL层面字段覆盖（最简单） #

直接在查询中显式指定item_state的code并沿用原字段名，利用JDBC结果集的字段覆盖特性：

select item.*, itm_s.id, itm_s.code as code
from items item
inner join item_state itm_s on item.id = itm_s.id

原理：当结果集中出现重复列名时，JDBC会保留最后出现的字段值，Spring JPA映射实体时会用这个值覆盖原items表的code。这种方式完全不用改代码，只需要调整SQL语句，是最快捷的方案。

2. 新增DTO继承原实体类 #

如果担心SQL覆盖的兼容性问题，可以新增一个DTO类继承原Item实体，重写code属性，然后用构造器查询：

// 新增DTO，无需修改原Item类
public class ItemWithStateCode extends Item {
    // 重写code属性，继承父类其他所有字段
    private String code;

    // 构造器要匹配查询返回的字段顺序：item的所有字段 + itm_s.id + itm_s.code
    public ItemWithStateCode(/* 按item字段顺序写参数，最后加Long stateId, String code */) {
        // 给父类属性赋值，最后给this.code = code;
    }
}

然后在Repository中定义查询：

@Query(value = "select new com.yourpkg.ItemWithStateCode(item.*, itm_s.id, itm_s.code) from Item item join ItemState itm_s on item.id = itm_s.id")
List<ItemWithStateCode> findItemsWithStateCode();

这种方式不用修改原实体，只是新增一个DTO，类型安全，适合需要强类型返回的场景。

3. 原生查询返回Map手动处理 #

如果不想新增类，可以用原生查询返回Map<String, Object>，之后手动把item_state的code赋值给实体：

@Query(value = "select item.*, itm_s.id as state_id, itm_s.code as state_code from items item inner join item_state itm_s on item.id = itm_s.id", nativeQuery = true)
List<Map<String, Object>> findItemsWithStateCode();

业务代码中处理：

List<Map<String, Object>> resultMaps = itemRepository.findItemsWithStateCode();
List<Item> items = resultMaps.stream().map(map -> {
    Item item = new Item();
    // 用Spring BeanUtils或手动映射item的字段
    BeanUtils.populate(item, map);
    // 替换code为state_code的值
    item.setCode((String) map.get("state_code"));
    return item;
}).collect(Collectors.toList());

这种方式灵活，不用新增类，但需要手动处理映射，适合临时场景。

4. 用@SqlResultSetMapping配置映射 #

可以在原实体类上添加结果集映射配置，指定把item_state的code映射到实体的code字段，无需修改实体属性：

@Entity
@SqlResultSetMapping(
    name = "ItemWithStateCodeMapping",
    entities = @EntityResult(
        entityClass = Item.class,
        fields = {
            // 只需要显式指定要覆盖的字段，其他字段自动映射
            @FieldResult(name = "code", column = "state_code")
        }
    ),
    // 如果需要额外的itm_s.id，添加列结果
    columns = @ColumnResult(name = "state_id")
)
public class Item {
    // 原实体类代码不变
}

然后Repository中指定映射：

@Query(value = "select item.*, itm_s.id as state_id, itm_s.code as state_code from items item inner join item_state itm_s on item.id = itm_s.id", nativeQuery = true)
@SqlResultSetMapping(name = "ItemWithStateCodeMapping")
List<Item> findItemsWithStateCode();

这种方式属于JPA标准配置，适合需要复用映射规则的场景。

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