EF Core 7不支持Oracle原生JSON类型，推荐用string字段配合自定义ValueConverter实现序列化/反序列化，映射到NCLOB或VARCHAR2，并避免使用.HasColumnType("JSON")；复杂JSON查询需用FromSqlRaw或原生OracleCommand。
Oracle JSON列在EF Core 7里不能直接映射
ef core 7原生不支持oracle的json数据类型（比如json、jsonb或is json约束），oracle官方驱动oracle.entityframeworkcore 7.x也未提供jsondocument或string到数据库json类型的自动序列化/反序列化管道。你写public jsondocument metadata { get; set; }，运行时会报system.invalidoperationexception: the property 'entity.metadata' could not be mapped。
用string + 自定义ValueConverter是最稳的方案
把JSON列当纯文本处理，靠ValueConverter在读写时做string ↔ T转换。这是目前兼容性最好、可控性最强的做法，且不依赖Oracle驱动版本更新。
-
string字段映射到NCLOB或VARCHAR2(4000)（注意长度限制） - 转换器必须处理
null、空字符串、格式错误的JSON（避免JsonSerializer.Deserialize抛异常中断查询） - 推荐用
System.Text.Json而非Newtonsoft.Json，减少依赖冲突 - 示例转换器：
var jsonConverter = new ValueConverter<MyData, string>(
model => model == null ? null : JsonSerializer.Serialize(model, (JsonSerializerOptions) null),
dbVal => string.IsNullOrWhiteSpace(dbVal) ? null : JsonSerializer.Deserialize<MyData>(dbVal, (JsonSerializerOptions) null)
);
然后在OnModelCreating中应用：
modelBuilder.Entity<MyEntity>()
.Property(e => e.Data)
.HasConversion(jsonConverter)
.HasColumnType("NCLOB"); // Oracle侧显式指定大文本类型
别踩HasColumnType("JSON")这个坑
有人看到Oracle 21c+支持JSON类型，就尝试写.HasColumnType("JSON")，结果发现：
- EF Core 7会忽略该设置，仍按默认规则生成DDL（通常是
VARCHAR2） - 即使手动建表用了
JSON列，EF Core读取时仍当作string返回，不会触发校验或解析 -
IS JSON约束完全由数据库执行，EF Core不感知、也不帮你维护
所以HasColumnType("JSON")在当前版本只是“装饰性写法”，实际没作用，还可能误导后续维护者。
如果必须用原生JSON函数（如JSON_VALUE），得绕开EF Core映射
EF Core不支持Oracle JSON路径查询语法，像SELECT JSON_VALUE(data, '$.name') FROM t无法用LINQ表达。这时只能：
- 用
FromSqlRaw手写SQL，返回DTO（不是实体） - 在
DbContext里暴露Database.GetDbConnection()，用OracleCommand直连执行 - 避免在
Where里传入JSON字段做复杂过滤——它大概率会全表扫描，且无法利用JSON索引（除非你额外建JSON_SEARCH虚拟列并索引）
真正棘手的不是怎么读，而是怎么让查询走索引。Oracle JSON索引依赖虚拟列+函数索引组合，EF Core完全不参与这部分建模。
