在不改动主实体类的前提下，可通过 spring data jpa 的接口/类投影（projection）机制，在 `@query` 中显式指定字段（包括从关联表选取的冗余列），并映射到自定义 dto 或接口，从而解决多表同名列冲突与字段覆盖问题。
当使用 Spring Data JPA 时，若需在 SELECT 查询中从关联表（如 item_state）获取一个与主表（如 items）同名的字段（例如 code），而必须优先取关联表的值，同时又不想手动列出 items 表全部 100+ 列、也不愿修改现有实体类结构，标准的 @Query + 投影（Projection） 是最优雅且类型安全的解决方案。
✅ 正确做法：使用 JPQL 投影 + 自定义返回类型
首先，*避免使用原生 SQL 的 `select `** —— 它无法控制字段来源，也无法与 JPA 实体映射兼容。应改用 JPQL，并显式声明所需字段：
@Repository
public interface ItemRepository extends JpaRepository<Item, Long> {
@Query("SELECT new com.example.dto.ItemWithStateCode(" +
" item.id, item.name, item.description, /* ... 其他必要字段 */ " +
" itm_s.code" +
") FROM Item item " +
"JOIN item.itemState itm_s " +
"WHERE item.id = itm_s.id")
List<ItemWithStateCode> findAllWithStateCode();
}⚠️ 注意：item.itemState 是 Item 实体中定义的 @OneToOne 或 @ManyToOne 关联属性名（非数据库表名），确保其已正确映射。
? 推荐方案：接口投影（更简洁、无需构造器）
若字段较多，手动列举易出错，可采用 接口投影（Interface-based Projection），由 Spring Data JPA 自动代理实现：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public interface ItemWithStateCode {
// 主表字段（按实际 getter 命名）
Long getId();
String getName();
String getDescription();
// ... 其他 items 字段的 getter
// 关键：明确来自 item_state 的 code，覆盖主表同名字段
String getCode(); // Spring 将自动绑定 JOIN 中的 itm_s.code
}对应仓库方法：
@Query("SELECT item, itm_s.code FROM Item item JOIN item.itemState itm_s WHERE item.id = itm_s.id")
List<ItemWithStateCode> findAllProjectedWithStateCode();✅ 此写法中：
- item 代表整个 Item 实体（Spring 会自动填充其所有映射字段）；
- itm_s.code 作为额外字段，通过同名 getter getCode() 被识别并注入；
- 无需修改 Item 实体类，也无需重写全部 100+ 列。
? 验证与注意事项
- JPQL 路径必须基于对象模型：item.itemState 是 Java 属性路径，不是数据库表名 item_state；确保 Item 类中已正确定义该关联关系及 @JoinColumn。
- 字段歧义处理：若两个表均有 code，但仅声明 itm_s.code，则投影接口中的 getCode() 必然解析为该值——这是 JPQL 显式绑定的确定性行为，完全规避了 SELECT * 的模糊性。
- 性能提示：对超宽表（100+ 列），建议只投影业务真正需要的字段，而非盲目使用 item.*；接口投影虽便捷，但底层仍会加载完整 Item 实体，如需极致性能，可结合 @SqlResultSetMapping 使用原生查询 + @ConstructorResult。
✅ 总结
| 方案 | 是否需改实体 | 是否支持同名列覆盖 | 推荐度 |
|---|---|---|---|
| 手动列清单 + DTO 构造器 | 否 | ✅（显式指定） | ⭐⭐⭐⭐ |
| 接口投影 + item, itm_s.code | 否 | ✅（getter 绑定明确来源） | ⭐⭐⭐⭐⭐ |
| 原生 SQL + SELECT * | 否 | ❌（无法区分同名列） | ⛔ 不推荐 |
最终，接口投影配合 JPQL 显式 JOIN 字段，是兼顾可维护性、类型安全与零侵入性的最佳实践。
