H2内存数据库SQL参数报错：expected "ALL, ANY, SOME, SELECT, FROM, WITH"

这个问题核心是Spring JDBC Template的参数占位符规则和H2控制台的参数处理逻辑不一致导致的，不是H2数据库本身的参数传递机制问题，具体分析和解决方案如下：

问题原因 #

你在SQL里用了:runDate、:securityCode这种命名参数占位符，但调用的是普通JdbcTemplate的query方法——这个方法只支持位置占位符?，不会解析:xxx格式的命名参数。当未被处理的SQL直接传给H2数据库时，H2无法识别:runDate这类语法，就会抛出"expected ALL, ANY, SOME, SELECT, FROM, WITH"的语法错误。

而H2控制台能正常运行，是因为控制台本身内置了对命名参数的解析逻辑，会自动把:param替换成你输入的参数值，相当于提前完成了参数替换，所以不会触发语法错误。

解决方案 #

有两种方式可以解决这个问题，根据你的需求选择：

方案1：改用位置占位符? #

把SQL里的命名占位符替换成?，保持参数顺序和Object[]里的顺序一致：

SELECT CF.*, ROWNUM CASHFLOW_INDEX FROM ( 
    SELECT * FROM TB_CASHFLOWS CFW 
    WHERE CFW.CASHFLOW_DATE >= ? 
      AND CFW.CASHFLOW_TYPE <> 'ISSUE' 
      AND CFW.ISIN = ? 
    ORDER BY CFW.CASHFLOW_DATE, CFW.CASHFLOW_TYPE ASC 
) CF

对应的Java代码不需要改动，因为Object[]的参数顺序已经和?的位置对应匹配。

方案2：使用NamedParameterJdbcTemplate支持命名参数 #

如果你想保留命名参数的可读性，推荐使用Spring提供的NamedParameterJdbcTemplate，它专门支持:xxx格式的命名参数：

// 用Map存储命名参数
Map<String, Object> paramMap = new HashMap<>();
paramMap.put("runDate", "2017-02-28");
paramMap.put("securityCode", "USD_TREASURY_28FEB");

// 创建NamedParameterJdbcTemplate实例（可直接复用现有JdbcTemplate的数据源）
NamedParameterJdbcTemplate namedJdbcTemplate = new NamedParameterJdbcTemplate(getJdbcTemplate());

// 执行查询
List<Cashflow> instrumentCashflows = namedJdbcTemplate.query(
    cashflowsQuery, 
    paramMap, 
    new BeanPropertyRowMapper<>(Cashflow.class)
);

这种方式不需要修改原SQL，代码可读性更高，也不容易因为参数顺序调整而出错。

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