oracle 12c+ json类型不被jpa原生支持，需通过attributeconverter映射map/objectnode到clob实现序列化，或用hibernate usertype+自定义方言支持json函数；ddl-auto=validate会因类型不匹配报错，应禁用并改用liquibase/flyway管理schema。
Oracle 12c+ 的 JSON 类型不被 JPA 原生支持
Oracle 自 12c 起提供 JSON 数据类型（底层是 VARCHAR2/CLOB + 内置校验），但标准 JPA 规范（包括 Hibernate 6.4+）仍不识别 @Column(columnDefinition = "JSON") 或类似声明——直接使用会触发 ORA-00902: invalid datatype 错误，或被静默转为 TEXT/CLOB 丢失 JSON 功能（如 IS JSON 约束、路径查询）。必须通过自定义类型桥接。
用 AttributeConverter 映射 Java Map/ObjectNode 到 CLOB
这是最轻量、兼容性最好的方式：将 JSON 字段声明为 CLOB，在 Java 层用 Jackson 序列化/反序列化。无需改 DDL，不依赖 Oracle 特有 API。
- 实体字段保持
@Column(name = "meta", columnDefinition = "CLOB")（CLOB是 Oracle 推荐的 JSON 容器） - 实现
AttributeConverter<map object>, String></map>，用ObjectMapper双向转换 - 注意空值处理：
convertToDatabaseColumn(null)应返回null，而非空字符串，否则 Oracle 会存入''导致IS JSON校验失败 - 若需保留格式缩进（调试用），可在
ObjectMapper中启用SerializationFeature.INDENT_OUTPUT，但生产环境建议关闭以节省空间
用 Hibernate UserType 支持原生 JSON 操作（如 json_exists）
若业务强依赖 Oracle JSON 函数（例如 SELECT * FROM t WHERE json_exists(meta, '$.status')），必须让 Hibernate 知道该字段是 JSON 类型，否则 HQL/JPQL 无法生成合法 SQL。此时需注册自定义 UserType 并配置方言。
- 继承
org.hibernate.usertype.UserType，重写nullSafeGet/nullSafeSet，内部用PGobject类似思路（但 Oracle 用oracle.sql.CLOB或String） - 扩展
OracleDialect（如CustomOracleDialect extends OracleDialect），调用registerColumnType(Types.OTHER, "JSON") - 在
application.yml中指定：spring.jpa.database-platform: com.example.CustomOracleDialect - ⚠️ 风险：Hibernate 6.2+ 对 Oracle JSON 支持仍不稳定，某些 JPQL 函数（如
json_value）需手写@Query(nativeQuery = true)绕过
ddl-auto: validate 会因 JSON 字段报错，必须禁用
JPA 启动时若启用 spring.jpa.hibernate.ddl-auto=validate，Hibernate 会尝试比对实体字段类型与数据库列类型。由于它不认识 JSON，会把 DB 中的 JSON 列识别为 OTHER，而实体中声明的 CLOB 或 String 是 LONGVARCHAR，类型不匹配直接抛 SchemaManagementException。
- 解决方案：设为
none或update（但update不会修改列类型，仅增删字段） - 更安全的做法：关掉自动 DDL，用 Liquibase/Flyway 管理 schema，把
meta CLOB CHECK (meta IS JSON)写进 migration 脚本 - 验证 JSON 数据完整性应放在应用层：插入前用
ObjectMapper.readTree(jsonStr)捕获JsonProcessingException
真正麻烦的不是序列化，而是让查询语义穿透到 Oracle 的 JSON 引擎里——JPA 抽象层越厚，越难暴露底层能力。如果项目已重度依赖 json_table 或 json_mergepatch，不如直接在 @Query 中写原生 SQL，别硬套 JPA。
