C# 将原始JSON存为SQL数据库字段应选用何种数据类型

你现在遇到的超8000字符就存空的问题，本质不是所选字段类型的容量上限不够——nvarchar(MAX)单字段最多可以存储2GB的文本内容，完全覆盖400KB级别的JSON存储需求，问题出在配置没生效，导致数据库里实际的字段根本不是nvarchar(MAX)类型。

可落地的配置修改方案 #

• 显式指定EF Core的字段映射规则，避免被默认约定覆盖
  你现在只定义了public string Json { get; set; }，没有显式声明字段类型，EF Core很多版本的默认逻辑会把未指定长度的字符串映射为nvarchar(4000)，碰到带全局约定规则的项目甚至会直接截断长内容。可以直接给属性加数据注解强制指定类型：

  [Column(TypeName = "nvarchar(max)")]
  public string Json { get; set; }
  

  如果用Fluent API做配置，等价的写法是在OnModelCreating方法中添加：

  modelBuilder.Entity<WixOrder>()
      .Property(order => order.Json)
      .HasColumnType("nvarchar(max)");
  

• 升级为SQL Server原生JSON类型（适配SQL Server 2016及以上版本）
  如果你用的SQL Server版本支持原生json类型，可以直接用这个替代nvarchar(max)。它的存储容量和nvarchar(max)完全一致，额外提供原生JSON格式校验、内置JSON路径查询能力，更适合存调试用的原始JSON内容，不会出现编码兼容问题。对应的C#配置和上面类似，只需要把类型名改成json即可：

  [Column(TypeName = "json")]
  public string Json { get; set; }
  

必做的排错步骤 #

• 配置修改后重新生成迁移脚本，更新数据库结构，不要依赖旧的迁移结果。生成脚本后可以先检查脚本里对这个字段的定义，确认是nvarchar(max)或者json类型，不是nvarchar(4000)这类短长度类型。
• 直接到数据库管理工具里查看实际的表结构：很多人踩坑是因为早期的迁移把字段建成了短长度类型，后续改了C#代码但没同步更新数据库结构，长内容存进去自然会被截断甚至置空。
• 检查项目全局的EF约定配置：部分项目会添加全局规则，把所有未标记长度的字符串默认限制为固定长度，这类规则会覆盖你单独给某个属性做的类型配置。
• 不要给这个Json属性加任何[MaxLength]特性，只要加了长度标记，EF就会严格按标记值建字段，不会自动使用最大长度。

内容的提问来源于stack exchange，提问作者Paul Clark