GridDB Java API写Instant到TIMESTAMP列报类型不匹配

核心结论 #

GridDB Java Client API 的Row.setTimestamp()方法原生不支持直接传入java.time.Instant类型值，直接传入会触发你遇到的[145002:GS_ERROR_DATA_TYPE_MISMATCH]类型不匹配报错。
该方法官方明确支持的入参类型仅为java.util.Date及其子类java.sql.Timestamp，这也是现有官方示例均采用这两类时间类型的原因。

Java 8+ 日期API适配方案 #

你提到的转换写法是官方推荐的兼容方案，完全可用：

row.setTimestamp(
    0,
    java.sql.Timestamp.from(Instant.now())
);

这个方案的优势在于：

• 不需要额外手动计算时间戳毫秒值，避免手动转换时容易出现的时区偏移、精度丢失问题
• java.sql.Timestamp支持纳秒级精度，和GridDB TIMESTAMP类型的精度完全匹配，不会丢失Instant携带的亚毫秒时间信息
• 代码可读性好，直接衔接Java 8+的java.time时间体系，不需要侵入原有时间逻辑做冗余改造

其他可选方案说明 #

如果你的业务场景不需要亚毫秒级时间精度，也可以使用java.util.Date做转换传入：

row.setTimestamp(0, java.util.Date.from(Instant.now()));

注意java.util.Date仅支持毫秒级精度，会截断Instant中毫秒以下的时间值，对时间精度要求高的传感器、时序数据场景不推荐使用。

不要通过手动拼接毫秒值、格式化字符串的方式传入时间字段，这类写法很容易受本地JVM时区配置影响出现时间偏移问题，稳定性远低于官方支持类型的原生转换方法。

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