如何在JDBI中添加可选列？PostgreSQL场景问题排查与解决

问题根源 #

1. 参数名不匹配：GROUP BY子句里写了:byPortfolio2，但Java方法只绑定了byPortfolio参数，JDBI没法正确替换这个未绑定的参数，导致PostgreSQL解析时无法识别条件，触发了分组校验规则——要求ia1.investmentAccountAbbreviationCode必须出现在GROUP BY或聚合函数中。
2. 实现逻辑偏差：用case when只能控制列值是否为null，但列本身始终存在，根本没法实现“不显示列”的需求；同时参数替换异常时，直接触发了PostgreSQL的语法校验错误。

最优解决方案（基于StringTemplate动态生成SQL） #

利用JDBI的@UseStringTemplateSqlLocator特性，通过StringTemplate的条件语法动态添加列和分组项，不用写两段重复的长SQL：

1. 修改sql.stg模板文件

getSolutionOwnershipPercentageOfFundByDate(inputDate, fundSeriesId, governanceCommitteeTypeCode, byPortfolio, assetClass, vehicleType) ::= <<
SELECT
  -- 保留原有50行SQL里的其他列
  <if(byPortfolio)>
    , ia1.investmentAccountAbbreviationCode AS portfolio
  <endif>
FROM -- 保留原有表关联逻辑
WHERE 
  input_date = :inputDate
  AND fund_series_id = :fundSeriesId
  -- 保留原有其他WHERE条件
GROUP BY
  -- 保留原有分组列
  <if(byPortfolio)>
    , ia1.investmentAccountAbbreviationCode
  <endif>
-- 保留原有ORDER BY等其他逻辑
>>

通过<if(byPortfolio)>条件判断，只有当byPortfolio为true时，才把portfolio列加入SELECT列表，同时把对应字段加入GROUP BY子句；为false时完全不生成这部分代码，彻底规避分组校验问题。

2. 确认Java方法参数绑定
   确保方法里的@Bind("byPortfolio")和模板中的byPortfolio变量名完全一致，不需要额外添加其他参数。

方案优势 #

• 避免重复SQL：用动态模板逻辑复用核心代码，只在需要时插入额外的列和分组项，不用维护两份几乎一样的长SQL。
• 符合PostgreSQL规则：动态生成的SQL在byPortfolio=false时不会包含该字段，完全绕过分组校验；true时字段同时出现在SELECT和GROUP BY中，满足语法要求。
• 精准实现需求：真正做到“显示/不显示列”，而非仅仅控制列值为null。

额外注意点 #

• StringTemplate语法要正确：动态结构用<if(变量名)>，参数绑定用:变量名，别搞混。
• 测试两种场景：分别验证byPortfolio=true和false时生成的SQL是否符合预期，可通过JDBI日志打印生成的SQL语句排查问题。

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