EF Core 7+ 官方不支持 Oracle 原生 JSON 类型，.HasColumnType("JSON") 会被静默忽略，实际仅支持 NCLOB 或 VARCHAR2(4000) 配合手动序列化/反序列化或 IS JSON 约束。
EF Core 7+ 不支持 Oracle 原生 JSON 列类型
直接写 .HasColumnType("JSON") 是无效的——EF Core 会静默忽略它，最终生成的 DDL 仍是 VARCHAR2 或 NCLOB，读取时也只返回 string，不会自动解析为对象。这不是配置遗漏或驱动问题，而是 EF Core 官方至今（2026 年 9 月）未实现 Oracle JSON 类型支持，Oracle.EntityFrameworkCore 包里也没有对应逻辑。
实际可行的映射方式只有两种
你必须在「数据库存储格式」和「C# 端处理逻辑」之间做明确取舍：
-
方案一（推荐）：用
NCLOB存，手动序列化/反序列化
在实体中声明为string或JsonDocument，配合.HasConversion()使用System.Text.Json：modelBuilder.Entity<Product>() .Property(p => p.Metadata) .HasColumnType("nclob") .HasConversion( json => JsonSerializer.Serialize(json, (JsonSerializerOptions)null), str => JsonSerializer.Deserialize<MetadataDto>(str, (JsonSerializerOptions)null));注意：不要用老版本的JsonConverter<T>，它已被废弃且不兼容原生 JSON 操作。 -
方案二：用
VARCHAR2(4000)+IS JSON约束
适合小而固定的 JSON 结构（如配置项）。建表语句需显式加检查约束：CREATE TABLE products (id NUMBER, metadata VARCHAR2(4000) CONSTRAINT chk_metadata_json CHECK (metadata IS JSON));
EF Core 中仍按string映射，但数据库层能校验合法性；缺点是长度受限，且无法使用JSON_VALUE等函数下推计算。
别踩这些坑
常见错误不是代码写错，而是对 Oracle 和 EF Core 的协作边界理解偏差：
- 试图让
JSON_OBJECT查询结果直接绑定到 C# 对象——JDBC 层不识别 Oracle 原生 JSON 类型，必须用rs.getObject("col", String.class, SQLType.JSON)才能拿到字符串，EF Core 根本没走这层。 - 在已有表上执行
ALTER TABLE ... MODIFY col JSON——Oracle 19c 不允许这样改类型，必须ADD新列 →UPDATE迁移 →DROP旧列。 - 依赖 EF Core 自动识别
IS JSON约束并启用结构感知——Oracle 只有真正声明COLUMN JSON才开启路径访问优化，EF Core 却连这个类型都映射不了。
如果你真需要数据库级 JSON 功能
就得绕过 EF Core 的列映射，直接用原始 SQL 配合 Oracle 特有语法：JSON_VALUE、JSON_EXISTS、JSON_TABLE 都得手写在 FromSqlRaw() 或存储过程中。EF Core 只负责把结果映射成 string 或自定义 DTO，解析和类型转换全在应用层完成。这点和 PostgreSQL 的 jsonb 或 SQL Server 的 json 完全不同——Oracle 的 JSON 能力强，但 ORM 支持弱，不能指望“开箱即用”。
