ef core 6+仅对dictionary、无主键类、ienumerable等特定类型自动识别为json列，且需数据库提供程序支持；sql server/postgresql需显式调用hascolumntype("json")或("jsonb")并配合tojson()，oracle不支持原生json类型。
EF Core 6+ 原生支持 JSON 列映射，但「支持」不等于「开箱即用」——它只对特定类型自动触发，且行为高度依赖数据库提供程序（SQL Server、PostgreSQL、SQLite 行为不同），Oracle 甚至完全不支持原生 JSON 类型。直接写 public Dictionary<string object> Metadata { get; set; }</string> 然后跑迁移，大概率报错或存成空字符串。
哪些类型能被 EF Core 自动识别为 JSON 列
EF Core 在模型构建阶段扫描属性类型，满足以下任一条件时，会默认启用 JSON 序列化（前提是数据库提供程序支持）：
-
Dictionary<string tvalue></string>、IEnumerable<t></t>、List<t></t>等集合类型（不含主键的类也归入此类） - 无主键的普通类（如
Address、ProductSpec），且未被标记为[Owned]或配置为关系实体 - 接口类型（如
IEnumerable<string></string>），但需注意反序列化时无法推断具体实现类型
⚠️ 注意：自定义结构体（struct）、record、含私有构造函数的类，不会被自动识别；必须手动配 HasConversion() 或显式调用 ToJson()。
SQL Server 和 PostgreSQL 怎么启用 JSON 列（不是 string）
EF Core 不会因为你用了 Dictionary 就自动建 json 类型列——它取决于提供程序是否注册了对应类型映射。SQL Server（2016+）和 PostgreSQL（12+）支持，但需显式声明：
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
- SQL Server：在
OnModelCreating中对属性调用.HasColumnType("json")，例如：modelBuilder.Entity<product>()<br> .Property(p => p.Attributes)<br> .HasColumnType("json");</product> - PostgreSQL：用
"jsonb"（推荐）或"json"：.HasColumnType("jsonb") - 两者都必须配合
.HasConversion()或.ToJson()，否则仍按默认规则映射为nvarchar(max)或text
❌ 错误示范：.HasConversion(new JsonConverter<dictionary string>>())</dictionary> —— 这是老版本手动序列化的写法，EF Core 7+ 已废弃，且不会生成原生 JSON 列。
为什么 Oracle 不能用 .HasColumnType("JSON")
EF Core 7/8/9/11 均未实现 Oracle 原生 JSON 类型支持。你写 .HasColumnType("JSON")，EF Core 会静默忽略，DDL 仍生成 VARCHAR2 或 NCLOB，且读取时返回 string 而非自动解析对象。
- 运行时报错
System.InvalidOperationException: The property 'Entity.Metadata' could not be mapped，说明你试图用JsonDocument或未注册转换器的复杂类型 - 正确做法是坚持用
string字段 + 自定义ValueConverter<t string></t>，并在转换器中处理null、空串、JSON 格式错误（避免JsonSerializer.Deserialize抛异常中断整个查询） - 如果必须用 Oracle 的
IS JSON约束或JSON_VALUE函数，只能绕过 LINQ，改用FromSqlRaw或原生OracleCommand
NULL 值怎么安全处理（尤其 EF Core 8+）
JSON 列里字段缺失或显式为 null，映射到 C# 非可空类型（如 int、DateTime）时，EF Core 8 默认抛 InvalidOperationException。这不是 bug，是设计使然——它拒绝猜测语义。
- 最稳方案：把目标属性改为可空类型（
int?、DateTime?），EF Core 会自动跳过缺失字段，设为null - 若必须用非可空类型，得在自定义转换器里提供默认值，例如：
new ValueConverter<productspec string>(spec => JsonSerializer.Serialize(spec), json =><br> string.IsNullOrEmpty(json) ? new ProductSpec() : JsonSerializer.Deserialize<productspec>(json))</productspec></productspec>
- 查询时别直接写
Where(x => x.Metadata["price"] > 100)—— EF Core 8 不会帮你加IS NOT NULL，要手动补：.Where(x => x.Metadata != null && x.Metadata.RootElement.TryGetProperty("price", out var price) && price.GetInt32() > 100)
真正容易被忽略的是：JSON 列的 NULL 安全性不在 ORM 层统一解决，它分散在序列化逻辑、LINQ 翻译、数据库函数三处，任何一处漏掉，线上就可能出空引用或查询结果偏差。
