使用NamedParameterJdbcTemplate保存含java.time.Instant属性实体的问题求助

这个错误本质上是因为你用的postgresql:9.4.1212驱动版本太老了，它没有内置支持Java 8引入的java.time.Instant类型，所以Spring的NamedParameterJdbcTemplate没法自动推断对应的SQL类型。下面给你几个最佳解决办法，按推荐优先级排序：

1. 升级PostgreSQL JDBC驱动（最推荐） #

新版本的PostgreSQL JDBC驱动（比如42.x系列，完全兼容PostgreSQL 9.4及以上版本）已经原生支持Java 8的所有时间类型，包括Instant。只需要把你的依赖替换成最新的稳定版就行，比如：

<!-- Maven示例，Gradle同理 -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.6.0</version> <!-- 可以换成最新稳定版 -->
</dependency>

升级后，驱动会自动把Instant映射到PostgreSQL的TIMESTAMP WITH TIME ZONE类型，不需要修改任何业务代码，一劳永逸。

2. 手动指定SQL类型（不升级驱动时的首选） #

如果因为某些限制没法升级驱动，你可以在设置参数的时候显式指定对应的SQL类型，告诉JDBC驱动该怎么处理Instant：

// 假设你的插入SQL是 INSERT INTO table (create_time) VALUES (:createTime)
String sql = "INSERT INTO your_table (create_time) VALUES (:createTime)";
MapSqlParameterSource params = new MapSqlParameterSource();
// 显式指定类型为TIMESTAMP_WITH_TIMEZONE
params.addValue("createTime", yourEntity.getCreateTime(), Types.TIMESTAMP_WITH_TIMEZONE);

namedParameterJdbcTemplate.update(sql, params);

这样就能绕过驱动的类型推断问题，直接告诉它用带时区的时间戳类型来处理Instant。

3. 手动转换为驱动支持的类型（临时应急方案） #

你也可以在业务代码里把Instant转换成旧驱动支持的java.sql.Timestamp或者OffsetDateTime类型，再传入参数：

// 把Instant转成Timestamp
Timestamp timestamp = Timestamp.from(yourEntity.getCreateTime());
params.addValue("createTime", timestamp);

// 或者转成OffsetDateTime（PostgreSQL驱动对这个类型的支持也更好）
OffsetDateTime offsetDateTime = yourEntity.getCreateTime().atOffset(ZoneOffset.UTC);
params.addValue("createTime", offsetDateTime);

这种方法代码侵入性比较高，适合临时快速解决问题，但长期来看还是升级驱动更靠谱。

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