Azure流水线中Oracle反序列化ZonedDateTime毫秒值不一致问题

场景还原 #

本地环境用Java 17.0.8 + Oracle Docker容器运行单元测试全部通过；但Azure流水线采用Eclipse Adoptium提供的Java 17.0.10时，测试报错——从Oracle反序列化得到的ZonedDateTime毫秒值存在细微差异（例如709796802Z与709797Z），切换至Java 11后测试恢复正常。

Azure流水线的Maven@4任务配置：

- task: Maven@4
  displayName: 'Run Unit Test'
  inputs:
    mavenPomFile: 'pom.xml'
    goals: 'test'
    publishJUnitResults: true
    testResultsFiles: '**/surefire-reports/TEST-*.xml'
    testRunTitle: 'Unit Test Over Oracle Container'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: '17'
    mavenAuthenticateFeed: true
    effectivePomSkip: true
    options: '-Dmaven.repo.local=$(MAVEN_CACHE_FOLDER) -DfailIfNoTests=false -Dunit-test=true'

测试代码片段：

ZonedDateTime now = ZonedDateTime.now();
int updateCount = MyCustomerDao.updateCustomerEndDate(customer.getId(), now);

assertEquals(1, updateCount);

MyCustomer customerSaved = MyCustomerDao.findCustomerById(customer.getId());

assertAll(
        () -> assertNotNull(customerSaved),
        () -> assertEquals(now, customerSaved.getEndDate())
);

原因分析 #

1. JDK版本的时间API实现差异：Eclipse Adoptium基于OpenJDK，17.0.10版本对ZonedDateTime与JDBC交互的精度处理逻辑做了调整，和17.0.8版本的舍入/截断规则不一致，导致读写Oracle时间字段时出现精度偏差。
2. Oracle JDBC驱动适配问题：旧版本的Oracle JDBC驱动（如ojdbc11早期版本）对Java 17高版本的时间类型序列化/反序列化支持不完善，未正确处理纳秒级精度的转换。
3. Spring JPA的Hibernate处理逻辑：Hibernate在不同JDK版本下绑定时间参数、读取结果集时的精度处理逻辑存在差异，尤其当数据库字段（如TIMESTAMP WITH TIME ZONE）的存储精度和JDK时间对象精度不匹配时。

解决方案 #

1. 调整测试的时间精度比较逻辑 #

避免直接用assertEquals比较ZonedDateTime实例，改为比较到指定精度（如毫秒级），忽略纳秒差异：

assertAll(
        () -> assertNotNull(customerSaved),
        () -> assertEquals(
                now.truncatedTo(ChronoUnit.MILLIS),
                customerSaved.getEndDate().truncatedTo(ChronoUnit.MILLIS)
        )
);

如果用AssertJ断言库，可更简洁：

assertThat(customerSaved.getEndDate()).isEqualToIgnoringNanos(now);

2. 对齐Azure流水线的Java版本 #

将Azure的JDK版本切换为和本地一致的17.0.8（Eclipse Adoptium提供该版本），消除版本差异：

- task: Maven@4
  displayName: 'Run Unit Test'
  inputs:
    mavenPomFile: 'pom.xml'
    goals: 'test'
    publishJUnitResults: true
    testResultsFiles: '**/surefire-reports/TEST-*.xml'
    testRunTitle: 'Unit Test Over Oracle Container'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: '17.0.8' # 指定与本地一致的JDK版本
    mavenAuthenticateFeed: true
    effectivePomSkip: true
    options: '-Dmaven.repo.local=$(MAVEN_CACHE_FOLDER) -DfailIfNoTests=false -Dunit-test=true'

3. 升级Oracle JDBC驱动版本 #

确保使用适配Java 17的最新Oracle JDBC驱动（如ojdbc11的21.9.0.0及以上版本），修复高版本JDK下的时间处理bug。在pom.xml中更新依赖：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc11</artifactId>
    <version>21.9.0.0</version>
</dependency>

4. 配置Hibernate时间处理参数 #

在application.properties中添加配置，强制Hibernate使用指定的时间精度或时区处理逻辑：

# 强制时区处理模式，避免时区转换带来的精度问题
spring.jpa.properties.hibernate.jdbc.time_zone=UTC
# 禁用Oracle的时区区域转换，使用偏移量处理
oracle.jdbc.timezoneAsRegion=false

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