如何通过Spring JDBC向PostgreSQL插入timestampz类型数据

核心错误点 #

你的代码存在两个关键问题导致插入失败：

• SQL语句中给占位符添加TIMESTAMP WITH TIME ZONE前缀完全多余，反而会干扰JDBC对占位符的解析，引发参数绑定异常。
• 无需将ZonedDateTime格式化为字符串传递，直接传入Java时间对象才是JDBC参数绑定的正确方式，格式化字符串容易引入格式兼容问题。

正确实现代码 #

修正SQL语句并直接传递原始ZonedDateTime对象即可解决问题：

ZonedDateTime ts = ZonedDateTime.now();
// 移除占位符前的类型前缀，保持SQL语句简洁
String insertRetailPrice = "INSERT INTO retailprices VALUES (?, ?, ?);";
// 直接传入ZonedDateTime对象，Spring JDBC会自动完成类型映射
int retailPriceAffectedRows = jdbcTemplate.update(insertRetailPrice, SKU, price, ts);

额外注意事项 #

• 驱动版本要求：确保PostgreSQL JDBC驱动版本在4.2及以上，该版本开始原生支持Java 8时间API（ZonedDateTime、OffsetDateTime等），低版本驱动会出现类型不兼容异常。
• 更适配的时间类型：PostgreSQL的timestamp with time zone本质存储带偏移量的时间，使用OffsetDateTime传递参数会比ZonedDateTime更贴合底层存储逻辑，不过ZonedDateTime也能被驱动正确转换为对应偏移时间，两种类型均可使用。

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