Oracle TIMESTAMP WITH TIME ZONE 映射到 Java OffsetDateTime 失败，因 MyBatis 默认不支持 oracle.sql.TIMESTAMPTZ，需自定义 TypeHandler 并正确配置 jdbcType="OTHER"，同时注意驱动版本兼容性与类型语义匹配。
Oracle TIMESTAMP WITH TIME ZONE 字段映射到 Java OffsetDateTime 失败？
mybatis 默认不识别 oracle 的 timestamp with time zone，直接映射到 java.time.offsetdatetime 会抛 sqlexception: cannot convert to java.time.offsetdatetime。根本原因是 oracle jdbc 驱动返回的是 oracle.sql.timestamptz，而 mybatis 的默认类型处理器没注册对应转换逻辑。
解决路径很明确：用自定义 TypeHandler 拦截该类型，并委托 JDBC 驱动的 getOffsetDateTime() 方法解析：
- 在 MyBatis 配置中注册
OffsetDateTimeTypeHandler（需继承BaseTypeHandler<OffsetDateTime>） -
setNonNullParameter中调用preparedStatement.setObject(index, parameter, Types.OTHER)，避免驱动误判类型 -
getNullableResult中先判断resultSet.getObject()是否为oracle.sql.TIMESTAMPTZ，再转OffsetDateTime
MyBatis XML 映射里写 <result column="ts_col" property="eventTime" jdbcType="OTHER"/> 有用吗？
有用，但仅限于“绕过默认类型推断”，不是万能解。MyBatis 见到 jdbcType="OTHER" 就不会尝试用内置处理器，而是交由你注册的 TypeHandler 处理 —— 前提是你已全局或局部绑定了正确的 handler。
常见踩坑点：
- 只写
jdbcType="OTHER"却没配TypeHandler，结果还是走默认逻辑，报错照旧 - 在
<insert>或<update>中漏写jdbcType，导致插入时用Timestamp.valueOf()硬转，丢掉时区信息 - Oracle 列实际是
TIMESTAMP WITHOUT TIME ZONE，却强行设jdbcType="OTHER"，反而触发异常
为什么用 ZonedDateTime 而不用 OffsetDateTime？
Oracle 的 TIMESTAMPTZ 存的是带时区偏移（如 +08:00）的值，不包含夏令时规则，OffsetDateTime 语义完全匹配；ZonedDateTime 需要时区 ID（如 Asia/Shanghai），Oracle 并不存这个信息，硬转会导致时区 ID 丢失或误设为系统默认时区。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- Java 实体类字段必须声明为
OffsetDateTime，别用LocalDateTime或Timestamp - 如果业务强依赖时区 ID（比如要计算夏令时），得在应用层额外存一个
ZoneId字段，和TIMESTAMPTZ配合使用 - Oracle 查询时用
FROM_TZ(CAST(... AS TIMESTAMP), 'UTC')转换时区，比在 Java 层做withOffsetSameInstant()更可靠
Oracle JDBC 驱动版本低于 21c 时 getOffsetDateTime() 报 AbstractMethodError？
这是典型版本不兼容：Oracle 12.1 和 19c 驱动没有实现 ResultSet.getOffsetDateTime()，必须降级处理。最稳方案是改用 getTimestamp() + 手动提取时区偏移：
TIMESTAMPTZ timestamptz = (TIMESTAMPTZ) rs.getObject(columnName); Timestamp timestamp = timestamptz.timestampValue(conn); int offsetSeconds = timestamptz.getTimeZone().getRawOffset() / 1000; return OffsetDateTime.ofInstant(timestamp.toInstant(), ZoneOffset.ofTotalSeconds(offsetSeconds));
注意点：
- 不能直接调
timestamptz.toJdbc()，它返回的是Timestamp，丢掉偏移 - Oracle 12.1 驱动里
getTimeZone()返回的是固定偏移（非 IANA ID），所以只能用getRawOffset() - 升级到 ojdbc11（21c+）可一劳永逸，但需确认项目是否允许更换驱动
时区转换真正麻烦的从来不是代码怎么写，而是 Oracle 列定义、JDBC 驱动能力、Java 类型三者对齐的时机 —— 少一个环节，OffsetDateTime 就会悄悄变成 LocalDateTime。
