EF Core对接PostgreSQL处理可空属性触发22021编码错误求解

问题原因 #

你遇到的22021: invalid byte sequence for encoding "UTF8": 0x00错误，本质是PostgreSQL的文本类型（text/varchar等）不允许存储UTF8编码中非法的空字节\0，而SQL Server的nvarchar类型是支持空字节存储的，所以不管是从旧库迁移的存量数据，还是代码里生成的字段值，只要带了空字节就会触发这个报错。
注意你提到的可空值类型（int?/DateTimeOffset?）和导航属性ICollection<POS_Store>正常赋值C# null是不会触发编码错误的，问题大概率出在字符串类型字段的取值，或者赋值源带了非预期的空字节。

解决方案 #

1. 全局配置EF Core值转换器清理空字符（推荐，适合大量可空字段的项目） #

在你的DbContext的OnModelCreating方法中添加全局字符串转换逻辑，自动清理所有字符串字段中的空字节：

using Microsoft.EntityFrameworkCore.Storage.ValueConversion;

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 遍历所有实体的字符串属性，配置空字符清理逻辑
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        foreach (var property in entityType.GetProperties())
        {
            if (property.ClrType == typeof(string))
            {
                property.SetValueConverter(new ValueConverter<string, string>(
                    writeValue => writeValue == null ? null : writeValue.Replace("\0", string.Empty),
                    readValue => readValue
                ));
            }
        }
    }

    // 你原有其他的模型配置写在后面
}

2. 单独给指定字段加清理逻辑 #

如果不想全局修改，也可以单独给可能出问题的字符串属性加处理：

private string _hash;
public string Hash 
{ 
    get => _hash; 
    set => _hash = value?.Replace("\0", string.Empty); 
}

// 其他字符串属性同理修改

3. 存量数据迁移场景的处理 #

如果你是从SQL Server批量导数据到PostgreSQL，在导出阶段就先清理空字符，比如在SQL Server查询时用REPLACE函数处理：

SELECT REPLACE(Hash, CHAR(0), '') AS Hash, REPLACE(ForgetPasswordHash, CHAR(0), '') AS ForgetPasswordHash 
FROM POS_OwnerAccount

4. 排查导航属性的影响 #

你提到的ICollection<POS_Store> Stores是导航属性，从你贴的迁移代码看并没有映射到OwnerAccounts表的字段，所以它的null值不会触发插入错误，可以优先排除这个属性的影响，重点排查字符串类型的可空字段。

临时排查技巧 #

可以先逐个给可空字段手动赋值真正的C# null测试插入，定位具体是哪个字段的取值带了空字节，避免不必要的代码修改。

内容的提问来源于stack exchange，提问作者Alvin Stefanus