Entity Framework Core生成SQLite数据库上下文时，TEXT字段被识别为GUID却提示值格式不兼容的问题

我之前也碰到过一模一样的坑！用dotnet ef dbcontext scaffold生成SQLite的DbContext时，数据库里明明是TEXT类型存的GUID，脚手架自动把实体类里对应的属性映射成了Guid类型，但跑起来就报“GUID格式无效”的错误，折腾了好一阵才搞定。

问题根源 #

SQLite本身没有原生的GUID类型，大家一般用TEXT字段存GUID字符串，但EF Core的脚手架会自动识别那些看起来像GUID的TEXT列，默认映射成Guid类型。但如果你的数据库里存的GUID格式不是EF Core默认期望的（比如带大括号{}、全大写、没有分隔符的纯字符串），EF Core解析的时候就会直接报错。

解决办法，亲测有效！ #

根据你的需求，有两种方向可以选：

1. 继续用Guid类型，适配数据库的格式

如果还是想让实体类用Guid类型，那就在生成的DbContext里给对应字段加个类型转换器，告诉EF Core怎么把数据库里的TEXT字符串转成Guid，反过来又怎么转回去。

举个例子，假设你的Phases表的id字段存的是带大括号的GUID（比如{550e8400-e29b-41d4-a716-446655440000}），那就在DbContext的OnModelCreating方法里加这段配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 先保留脚手架生成的其他配置
    base.OnModelCreating(modelBuilder);

    // 针对Phases表的id字段配置转换
    modelBuilder.Entity<Phases>(entity =>
    {
        entity.Property(e => e.Id)
            .HasConversion(
                // 把Guid转成带大括号的字符串存到数据库
                v => $"{{{v.ToString()}}}",
                // 读取时去掉大括号再解析成Guid
                v => Guid.Parse(v.Trim('{', '}')));
    });
}

如果你的GUID是纯大写、不带分隔符的格式（比如550E8400E29B41D4A716446655440000），那就把转换逻辑改成用ParseExact：

.HasConversion(
    v => v.ToString("N").ToUpper(),
    v => Guid.ParseExact(v, "N"))

要是有很多这样的GUID字段，不想重复写配置，可以全局配置转换器：

protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
{
    configurationBuilder.Properties<Guid>()
        .HaveConversion<string>(
            v => v.ToString("N").ToUpper(),
            v => Guid.ParseExact(v, "N"));
}

2. 直接映射成string类型，避开格式问题

如果觉得处理Guid转换太麻烦，也可以直接把实体类里的属性改成string类型，让EF Core直接按TEXT字符串处理。

• 第一步：找到生成的Phases实体类，把public Guid Id { get; set; }改成public string Id { get; set; }
• 第二步：如果DbContext里有针对这个字段的Guid相关配置，记得删掉（比如HasColumnType("TEXT")可以保留，因为本来就是TEXT类型）

这样就不会有格式兼容的问题了，缺点是代码里要手动处理string和Guid的转换，但胜在简单直接。

小提醒：避免重新生成脚手架时覆盖配置

如果你以后还要用dotnet ef dbcontext scaffold --force重新生成代码，建议把自定义的实体配置放到分部类或者单独的配置文件里，比如创建一个PhasesEntityConfiguration.cs：

public class PhasesEntityConfiguration : IEntityTypeConfiguration<Phases>
{
    public void Configure(EntityTypeBuilder<Phases> builder)
    {
        // 这里放你的自定义配置
        builder.Property(e => e.Id)
            .HasConversion(...);
    }
}

然后在DbContext的OnModelCreating里调用：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.ApplyConfiguration(new PhasesEntityConfiguration());
    base.OnModelCreating(modelBuilder);
}

这样就算重新生成DbContext，你的自定义配置也不会被覆盖。

内容来源于stack exchange