使用Cassandra Java驱动如何为CQL timestamp列绑定值？

你当前写法失效大概率是Datastax驱动版本的API适配问题，不同版本的绑定API存在差异，以下是可直接落地的实现方案：

方案1：使用驱动内置的时间类型绑定（推荐） #

Datastax驱动对CQL的timestamp类型做了原生适配，不需要手动指定java.sql.Timestamp类作为参数类型：

• 如果你用的是Datastax Java Driver 3.x版本：
  直接调用setTimestamp方法绑定即可，示例代码：

  BoundStatement boundStatement = preparedStatement.bind()
    .setTimestamp(0, new java.sql.Timestamp(yourTimeMillis));
  

  也可以直接传入java.util.Date对象，驱动会自动做类型转换：

  boundStatement.setTimestamp(0, new Date(yourTimeMillis));
  

• 如果你用的是Datastax Java Driver 4.x版本：
  4.x版本废弃了旧的setXxx命名方法，统一用set方法配合驱动内置的CQL类型定义即可，不需要传入Java的Timestamp.class：

  import com.datastax.oss.driver.api.core.type.DataTypes;
  
  BoundStatement boundStatement = preparedStatement.bind()
    .set(0, Instant.ofEpochMilli(yourTimeMillis), DataTypes.TIMESTAMP);
  

  4.x驱动原生支持Instant类型作为CQL timestamp的映射类型，比旧的Timestamp类兼容性更好，不会出现时区偏移问题。

方案2：通过setObject方法兼容适配 #

如果上述方法都不生效，可以直接用通用绑定方法，驱动会自动识别时间类型的映射规则：

// 3.x版本写法
boundStatement.setObject(index, new Timestamp(yourTimeMillis));

// 4.x版本写法
boundStatement.setObject(index, Instant.ofEpochMilli(yourTimeMillis));

常见排查点 #

• 确认CQL表对应字段的类型确实是timestamp，而非date、time等其他时间类型
• 检查绑定的索引位置是否和预编译语句的占位符顺序一致，索引从0开始计数
• 4.x版本不要引入旧的java.sql.Timestamp作为参数，优先用Instant或ZonedDateTime避免时区转换异常

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