EF查询报错：无法将System.String转换为System.Guid求解决

问题分析 #

执行LINQ查询时抛出System.InvalidCastException，错误提示无法将System.String转为System.Guid，核心原因是实体类的Guid类型属性与数据库对应字段的类型不匹配，或者数据库中存在无法转换为Guid的字符串数据。

排查与解决步骤 #

1. 检查数据库表字段类型 #

查看InvitedUser表的UserAccountId和ReferrerAccountId字段：

• 若用SQL Server，确认字段类型是uniqueidentifier（而非varchar/nvarchar）；
• 若用MySQL等数据库，确认字段类型是char(36)（存储字符串格式Guid）或binary(16)（存储二进制Guid）。

若字段类型错误（比如用了字符串类型）：

直接修改数据库字段为对应Guid类型，同时确保现有数据都是有效的Guid值。

2. 配置EF类型转换（数据库字段为字符串类型时） #

如果数据库字段必须用字符串存储Guid格式数据，需在EF中显式配置转换规则：

方法1：使用Fluent API（推荐）

在DbContext的OnModelCreating方法中添加配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置UserAccountId的字符串与Guid转换
    modelBuilder.Entity<InvitedUser>()
        .Property(u => u.UserAccountId)
        .HasConversion(
            guid => guid.ToString(),
            str => Guid.Parse(str));
            
    // 配置ReferrerAccountId的字符串与Guid转换
    modelBuilder.Entity<InvitedUser>()
        .Property(u => u.ReferrerAccountId)
        .HasConversion(
            guid => guid.ToString(),
            str => Guid.Parse(str));
}

方法2：使用DataAnnotations

在实体类的Guid属性上添加[Column]注解指定类型，并确保数据格式正确：

[Key]
[Column(TypeName = "varchar(36)")]
public Guid UserAccountId { get ; set; }

[Column(TypeName = "varchar(36)")]
public Guid ReferrerAccountId { get ; set; }

3. 清理无效数据 #

如果数据库中UserAccountId或ReferrerAccountId字段存在不符合Guid格式的字符串值，需先修正或删除这些无效数据，否则Guid.Parse会抛出异常。

4. 验证查询代码 #

两种查询写法逻辑一致，无需修改：

// 异步写法
var result = await _db.InvitedUser.SingleOrDefaultAsync(_ => _.Email == Email);

// 同步写法
var result = _db.InvitedUser.Where(i => i.Email == Email).FirstOrDefault();

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