Spring Data JPA原生查询中如何绑定DTO的命名参数？

问题场景 #

请问在Spring Data JPA的原生SQL中是否支持绑定DTO参数？现有场景：包含50个字段的实体类，使用@NamedNativeQuery编写批量插入原生SQL，若在Repository方法中逐个传入50个参数可正常运行，但方法可读性极差。尝试通过:fieldDto.field1或:#{#fieldDto.field1}的方式绑定DTO字段参数均失败，后者启动时抛出异常“Space is not allowed after parameter prefix ':'”，求可行的实现方案。

代码示例：

@Entity
@Table(name = "my_very_usefull_field_tbl")
@NamedNativeQuery(
        name = INSERT_IGNORE_CONFLICT,
        query = "INSERT INTO my_very_usefull_field_tbl " +
                "(field1, " +
                "... " +
                "field50) " +
                "VALUES(:fieldDto.field1, " +
                "... " +
                ":fieldDto.field50) on conflict do nothing;"
)
public class MyVeryUsefullFieldEntity {
    @Id
    private String id;
    @Column(name = "field1")
    private String field1;
    @Column(name = "field2")
    private String field2;
    // ... 省略其他48个字段
    @Column(name = "field50")
    private String field50;
}

public interface MyVeryUsefullFieldRepository extends CrudRepository<MyVeryUsefullFieldEntity, String> {
    String INSERT_IGNORE_CONFLICT = "INSERT_IGNORE_CONFLICT";
   
    @Modifying
    @Query(name = INSERT_IGNORE_CONFLICT, nativeQuery = true)
    int insertIgnoreConflict(@Param("fieldDto") MyVeryUsefullFieldDto fieldDto);
}

可行实现方案 #

方案1：修正SpEL语法+直接使用@Query（推荐）

@NamedNativeQuery对SpEL表达式的支持有限，改用Repository方法上的@Query直接编写原生SQL，同时修正SpEL的语法（注意:和{之间不能有空格）：

public interface MyVeryUsefullFieldRepository extends CrudRepository<MyVeryUsefullFieldEntity, String> {
    @Modifying
    @Query(value = "INSERT INTO my_very_usefull_field_tbl " +
            "(field1, field2, ..., field50) " +
            "VALUES(:#{#fieldDto.field1}, :#{#fieldDto.field2}, ..., :#{#fieldDto.field50}) " +
            "on conflict do nothing;", nativeQuery = true)
    int insertIgnoreConflict(@Param("fieldDto") MyVeryUsefullFieldDto fieldDto);
}

该方案要求Spring Data JPA版本在2.x及以上，能直接通过SpEL解析DTO的属性值。

方案2：DTO转实体类传入

利用DTO和实体类字段高度匹配的特点，先将DTO转换为实体类，再绑定实体属性到SQL：

1. 修改@NamedNativeQuery的参数绑定：

@NamedNativeQuery(
        name = INSERT_IGNORE_CONFLICT,
        query = "INSERT INTO my_very_usefull_field_tbl " +
                "(field1, field2, ..., field50) " +
                "VALUES(:entity.field1, :entity.field2, ..., :entity.field50) " +
                "on conflict do nothing;"
)

2. 调整Repository方法参数：

public interface MyVeryUsefullFieldRepository extends CrudRepository<MyVeryUsefullFieldEntity, String> {
    String INSERT_IGNORE_CONFLICT = "INSERT_IGNORE_CONFLICT";
   
    @Modifying
    @Query(name = INSERT_IGNORE_CONFLICT, nativeQuery = true)
    int insertIgnoreConflict(@Param("entity") MyVeryUsefullFieldEntity entity);
}

3. 调用时通过对象映射工具（如ModelMapper、MapStruct）转换DTO到实体：

MyVeryUsefullFieldEntity entity = modelMapper.map(fieldDto, MyVeryUsefullFieldEntity.class);
repository.insertIgnoreConflict(entity);

该方案稳定性高，JPA对实体类的属性绑定支持更完善。

方案3：Service层提取DTO字段（兼容低版本）

如果无法使用SpEL，可在Service层手动提取DTO的所有字段，调用多参数的Repository方法：

1. Repository方法定义多参数：

public interface MyVeryUsefullFieldRepository extends CrudRepository<MyVeryUsefullFieldEntity, String> {
    @Modifying
    @Query(value = "INSERT INTO my_very_usefull_field_tbl " +
            "(field1, field2, ..., field50) " +
            "VALUES(:field1, :field2, ..., :field50) " +
            "on conflict do nothing;", nativeQuery = true)
    int insertIgnoreConflict(
        @Param("field1") String field1,
        @Param("field2") String field2,
        // ... 省略其他48个参数
        @Param("field50") String field50
    );
}

2. Service层调用：

public void saveField(MyVeryUsefullFieldDto fieldDto) {
    repository.insertIgnoreConflict(
        fieldDto.getField1(),
        fieldDto.getField2(),
        // ... 省略其他48个getter调用
        fieldDto.getField50()
    );
}

虽然参数较多，但可通过IDE自动生成getter调用，可读性优于直接硬写50个参数，且兼容性最强。

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