Spring Boot 3升级后NativeQuery参数类型无法解析问题求助

核心问题原因 #

你遇到的报错是因为在原生SQL查询中直接传递了Customer实体对象作为参数。Hibernate的原生查询不支持直接映射实体类作为参数值——原生SQL仅接受能直接对应数据库字段的基本数据类型（如String、Long、Integer等），无法自动解析实体对象的属性。

解决方案 #

1. 传递实体属性而非实体对象

修改方法参数，传入Customer中对应column1字段的具体属性值。假设Customer类中有getColumn1()方法获取对应字段的值，代码调整如下：

@Modifying(clearAutomatically = true, flushAutomatically = true)
@Query(value = "update table_name set column1=?3 where column1=?2 and parameter=?1", nativeQuery = true)
int myQuery(String parameter, String oldColumnValue, String newColumnValue);

调用方法时，传入oldValue.getColumn1()和newValue.getColumn1()即可。

2. 改用命名参数（推荐）

使用命名参数替代位置参数，既能避免位置顺序出错，也让代码可读性更强：

@Modifying(clearAutomatically = true, flushAutomatically = true)
@Query(value = "update table_name set column1=:newColumnVal where column1=:oldColumnVal and parameter=:param", nativeQuery = true)
int myQuery(
    @Param("param") String parameter,
    @Param("oldColumnVal") String oldColumnValue,
    @Param("newColumnVal") String newColumnValue
);

关于IntelliJ的SQL方言设置 #

当前设置为Generic SQL不会导致这个报错，该设置仅影响IDE的SQL语法提示、校验等编辑器层面的功能，和Hibernate运行时的参数解析逻辑无关。你可以将其改为PostgreSQL以获得更精准的SQL语法支持，但这不是解决当前问题的关键。

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