JPA原生查询报错：缺失IN/OUT参数（索引1），如何解决？

这个错误本质是JPA无法正确识别你绑定的命名参数，常见于原生SQL查询（NativeQuery）的参数绑定场景，尤其是部分JPA实现对命名参数的支持有限。下面给你几个可行的解决方案：

方案1：改用位置参数（最通用的解决办法） #

很多JPA实现（比如EclipseLink的部分版本）对原生SQL的命名参数支持并不完善，这时候改用位置参数就能快速解决问题。把SQL里的:tipologiaProdotto替换成?1，然后通过参数索引来绑定值：

public List<String> getTipoConsensoRichiesto(String tipologiaProdotto) {
    return entityManager.createNativeQuery(
            "Select TIPO_CONSENSO_RICHIESTO from PRIVACY_CONFIGURAZIONE WHERE TIPOLOGIA_PRODOTTO = ?1")
            .setParameter(1, tipologiaProdotto)
            .getResultList();
}

位置参数的优势是兼容性强，几乎所有JPA实现都支持，不会出现参数识别失败的问题。

方案2：开启JPA实现的命名参数支持（针对EclipseLink等） #

如果你坚持要用命名参数，可以检查你的JPA实现配置。以EclipseLink为例，你需要在persistence.xml中添加以下属性，强制开启原生SQL的参数绑定支持：

<properties>
    <property name="eclipselink.native.sql.bind-parameters" value="true"/>
    <property name="eclipselink.jdbc.bind-parameters" value="true"/>
</properties>

添加后重新启动应用，再测试你的查询是否正常工作。

方案3：检查参数名拼写与上下文 #

虽然你的代码看起来参数名是匹配的，但还是要仔细核对：

• 确保SQL中的参数名:tipologiaProdotto和setParameter方法中的第一个参数"tipologiaProdotto"完全一致（大小写、拼写都不能错）
• 确认entityManager是正确初始化的，没有出现null或者未注入的情况（不过这种情况通常会报空指针，不是参数缺失，但还是要排查）

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