API响应中java.sql.Timestamp格式不一致问题求助

我通过API接收java.sql.Timestamp对象，验证后返回JSON时，时间戳格式和输入不一致：

• 案例1：输入"2022-01-26T12:00:00.511+05:30"，响应中变成2022-01-26 12:00:00.511，丢失T和时区偏移+05:30
• 案例2：输入"2022-01-26T12:00:00.511Z"，响应中变成2022-01-26 17:30:00.511，丢失T且时间因时区转换被修改

要求返回格式严格和输入一致，保留完整的ISO 8601格式（包括T、时区偏移或Z），不改变时间值。

核心原因 #

1. java.sql.Timestamp的默认toString()方法输出格式为yyyy-MM-dd HH:mm:ss.SSS，天然不带T和时区信息
2. 若处理时将带时区的输入转换为本地时区（比如默认反序列化行为），会导致时间值被修改

解决方案 #

方案1：直接保留原始输入字符串 #

接收请求时，先以String类型存储原始时间字符串，验证时再转换为Timestamp，返回时直接复用原始字符串：

// 请求DTO类
public class TimeRequest {
    private String interval_time; // 用String接收原始ISO格式
    // getter、setter方法
}

// 业务处理逻辑
public ResponseEntity<ErrorResponse> checkExistingTimestamp(TimeRequest request) {
    // 验证时转换为Timestamp（处理T分隔符）
    String rawTime = request.getInterval_time();
    Timestamp timestamp = Timestamp.valueOf(rawTime.replace("T", " ").split("[+Z]")[0]);
    
    // 返回错误信息时直接用原始字符串
    ErrorResponse error = new ErrorResponse();
    error.setMessage("Already contains result for timestamp : " + rawTime);
    error.setHttpcode(409);
    error.setStatus("ERROR");
    return ResponseEntity.status(HttpStatus.CONFLICT).body(error);
}

方案2：使用Java 8+ 时间API（推荐） #

放弃java.sql.Timestamp，改用OffsetDateTime处理带时区偏移的时间，完整保留原始格式信息：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.time.OffsetDateTime;
import java.time.format.DateTimeFormatter;

// 请求DTO类
public class TimeRequest {
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX")
    private OffsetDateTime interval_time;
    // getter、setter方法
}

// 业务处理逻辑
public ResponseEntity<ErrorResponse> checkExistingTimestamp(TimeRequest request) {
    OffsetDateTime originalTime = request.getInterval_time();
    
    // 验证逻辑...
    
    // 格式化回原始ISO 8601格式
    String formattedTime = originalTime.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME);
    
    ErrorResponse error = new ErrorResponse();
    error.setMessage("Already contains result for timestamp : " + formattedTime);
    error.setHttpcode(409);
    error.setStatus("ERROR");
    return ResponseEntity.status(HttpStatus.CONFLICT).body(error);
}

关键注意事项 #

• 避免将带时区的时间转换为LocalDateTime（会丢失时区偏移信息）
• 若必须使用java.sql.Timestamp，不要依赖其toString()输出，始终复用原始输入字符串生成响应

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