JPA 原生 JPQL 不支持在 SELECT NEW 中嵌套 new 表达式（如 new Foo(..., new Bar(...))），但可通过重构目标类的构造函数，使嵌套对象字段由基础类型参数间接构建，从而在查询中仅传入原始字段值，实现类型安全的嵌套对象投影。
JPA 原生 JPQL 不支持在 `SELECT NEW` 中嵌套 `new` 表达式（如 `new Foo(..., new Bar(...))`），但可通过重构目标类的构造函数，使嵌套对象字段由基础类型参数间接构建，从而在查询中仅传入原始字段值，实现类型安全的嵌套对象投影。
在 Spring Data JPA 中，使用 SELECT NEW 构造自定义 DTO 是常见做法，但 JPQL 语法限制明确：NEW 关键字后只能调用一个构造函数，且该构造函数的所有参数必须直接来自查询投影字段或表达式——不支持在参数位置再次使用 new 创建嵌套对象。因此，以下写法是非法的：
@Query("SELECT NEW com.example.Foo(e.a, NEW com.example.Bar(e.b)) FROM Entity e")
List<foo> findFooWithNestedBar();</foo>
❌ 编译或运行时将抛出 org.hibernate.hql.internal.ast.QuerySyntaxException，提示无法解析嵌套 NEW。
✅ 正确解决方案：扩展构造函数，解耦嵌套对象创建
核心思路是：让 Foo 的构造函数既能接收 Bar 实例，也能接收构建 Bar 所需的原始参数（如 int b），从而在 JPQL 中只需传入字段值，由构造函数内部完成嵌套对象组装。
1. 重构 Foo 类（添加参数化构造函数）
public class Foo {
private final String a;
private final Bar bar;
// 主构造函数：接收完整对象（用于手动构建或非 JPQL 场景）
public Foo(String a, Bar bar) {
this.a = a;
this.bar = bar;
}
// 新增构造函数：接收原始字段，内部创建 Bar（专为 JPQL 投影设计）
public Foo(String a, int b) {
this(a, new Bar(b)); // 复用原有逻辑，保证一致性
}
// 可选：添加 getter 以支持后续使用
public String getA() { return a; }
public Bar getBar() { return bar; }
}
同时确保 Bar 类具有可访问的单参构造函数（已满足）：
public class Bar {
private final int b;
public Bar(int b) { this.b = b; }
public int getB() { return b; }
}
2. 编写 JPQL 查询（仅传原始字段）
@Repository
public interface FooRepository extends JpaRepository<entity long> {
@Query("SELECT NEW com.example.Foo(e.a, e.b) FROM Entity e")
List<foo> findFooWithBar();
// 或使用方法名查询（需字段名匹配）
// List<foo> findByAIsNotNull(); // 需配合 @Query 或 Projections 才能映射到 Foo
}</foo></foo></entity>
✅ 注意包名
com.example.Foo必须与实际类路径完全一致，且类必须是 public、非静态、非抽象 的普通 Java 类（即“Java Bean”风格 DTO）。
3. 使用示例与验证
@Service
public class FooService {
private final FooRepository fooRepository;
public List<foo> loadFooList() {
return fooRepository.findFooWithBar(); // 返回 List<foo>，每个 Foo.bar 已自动初始化
}
}</foo></foo>
调用后，每个 Foo 实例的 bar 字段均为有效 Bar 对象，无需额外映射或转换。
⚠️ 注意事项与最佳实践
-
不可使用 Lombok
@AllArgsConstructor自动生成嵌套构造函数：它会生成Foo(String, Bar)和Foo(String, int)两个构造器，但若字段顺序/类型不明确，JPQL 参数绑定易出错；建议显式声明，增强可读性与可控性。 - 避免在构造函数中执行复杂逻辑或 I/O 操作：JPQL 构造函数调用发生在 Hibernate 结果集映射阶段，应保持轻量、无副作用。
-
替代方案对比：
- ✅
SELECT NEW：类型安全、编译期检查、性能好（单次查询+构造）； - ⚠️
@SqlResultSetMapping+@ConstructorResult：更灵活但配置繁琐，适合复杂映射； - ❌
Object[]手动组装：失去类型安全，易出错，不推荐； - ? Spring Data JPA 3.0+ 支持
Projection接口或记录类（Record），可进一步简化（如record Foo(String a, Bar bar){}），但需确保构造参数可被 JPQL 直接提供。
- ✅
通过合理设计 DTO 构造函数，即可优雅绕过 JPQL 的语法限制，在保持代码简洁性的同时，获得类型安全、高性能的嵌套对象查询能力。
