Entity Framework Core/.NET Core 按Guid查询用户结果偶发为空异常

问题根源 #

该问题由C# Guid类型与数据库VARBINARY(16)存储的字节序不匹配导致：
C#的Guid采用混合端序存储，前4字节、接下来的两个2字节块为小端序，最后8字节为大端序；而MySQL等数据库默认将Guid转为大端序字节存入VARBINARY(16)字段，直接查询时字节无法匹配。
断点偶尔返回正确结果是因为EF Core的一级缓存命中：调用GetUsers()后全量User实体被加载到缓存，Find()会优先查缓存而非数据库，只有缓存中存在对应实体时才会返回正确结果，否则走数据库查询就返回null。外键报错也是同一原因：插入子表时生成的Guid字节与父表存储的字节不匹配，触发外键约束校验失败。

解决方案 #

方案1：改用CHAR(36)存储Guid（兼容性最好） #

直接将UserId字段的存储类型改为字符串格式的Guid，完全规避字节序问题：

1. 修改User模型的UserId属性配置，添加Column注解：

public class User
{
    [Column(TypeName = "char(36)")]
    public Guid UserId { get; set; } = Guid.NewGuid();
    public string EMail { get; set; }
    public string Name { get; set; }
    public string InstagramHandle { get; set; }
}

也可以在OnModelCreating中全局配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .Property(u => u.UserId)
        .HasColumnType("char(36)");
}

2. 生成新的EF迁移，更新数据库表结构，旧数据可同步转成char(36)格式后即可正常查询。

方案2：保留VARBINARY(16)存储，配置驱动Guid格式 #

如果需要保留VARBINARY(16)节省存储空间，可直接在数据库驱动配置中指定匹配的Guid格式（以Pomelo.EntityFrameworkCore.MySql为例）：

services.AddDbContext<ApplicationDbContext>(options =>
    options.UseMySql(
        connectionString, 
        new MySqlServerVersion("8.0.30"),
        mysqlOpt => mysqlOpt.GuidFormat(MySqlGuidFormat.Binary16)
    )
);

根据你的数据库实际存储的Guid字节序，可尝试MySqlGuidFormat枚举的以下值：Binary16、LittleEndianBinary16、TimeSwapBinary16，直到查询返回结果正常即可。

配置完成后，单条查询和外键插入问题会同步修复。

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