使用EF从MySQL分组查询会计期间时抛出InvalidCastException

我尝试用Entity Framework从MySQL数据库获取会计期间，但一直碰到InvalidCastException异常。

对应的LINQ语句如下：

var periodList = (from pd in _context.perioddates
                 join p in _context.periods on pd.PeriodId equals p.PeriodId
                 orderby pd.PeriodDate1 descending
                 group new { p, pd } by p.PeriodId into pdg
                 select pdg.FirstOrDefault()).ToList();

这个查询本应返回期间及其开始日期的列表（排除期间结束日期），但抛出了如下异常：

TargetInvocationException: 'Exception has been thrown by the target of an invocation

其内部异常为：

InvalidCastException: Specified cast is not valid.

This exception was originally thrown at this call stack: MySql.Data.MySqlClient.MySqlDataReader.GetByte(int)

period表的模型定义：

public partial class period
{
    public byte PeriodId { get; set; } // TinyInt Unsigned
    public long Period1 { get; set; } // Int Unsigned
    public string PeriodName { get; set; } // VarChar
}

perioddate表的模型定义：

public partial class perioddate
{
    public int PeriodDateId { get; set; } // SmallInt Unsigned
    public DateTime PeriodDate1 { get; set; } // DateTime
    public byte VariantId { get; set; } // Tiny Int
    public byte PeriodId { get; set; } // Tiny int
}

为什么分组查询会抛出这个异常？为什么提取TinyInt类型数据在分组时出问题，直接查询却能正常加载？

补充说明：
我所说的“直接查询”指不分组，直接获取所有记录的查询，示例如下：

var periodList = (from pd in _context.perioddates
                  join p in _context.periods on pd.PeriodId equals p.PeriodId
                  orderby pd.PeriodDate1 descending
                  select new PeriodModel()
                  {
                      PeriodId = p.PeriodId,
                      Period = p.Period1,
                      PeriodDateId = pd.PeriodDateId,
                      PeriodDate = pd.PeriodDate1
                  }).ToList();

这个查询能正常运行，但会包含结束日期。

问题原因分析 #

这个异常的核心是EF在处理分组查询时，对MySQL的TinyInt Unsigned类型的映射处理出现了偏差：

1. 分组查询的SQL转换差异：直接查询时，EF会直接将PeriodId（byte类型）映射到MySQL的TinyInt Unsigned，读取数据时调用合适的读取方法；但分组查询时，EF生成的SQL会对分组字段做额外处理，导致MySQL数据读取器尝试用GetByte()读取超出byte范围的值——因为MySQL的TinyInt Unsigned最大值是255，而如果分组逻辑中EF误将其当作有符号TinyInt（范围-128到127），或者在分组聚合时类型转换出错，就会触发InvalidCastException。
2. 模型映射的潜在问题：虽然模型中PeriodId定义为byte，但MySQL的TinyInt Unsigned在EF的MySQL驱动中，有时候需要显式配置映射，否则分组等复杂查询时驱动可能无法正确识别类型。

解决方案 #

方案1：显式配置类型映射 #

在DbContext的OnModelCreating方法中，为PeriodId字段显式指定MySQL类型，确保EF能准确识别字段属性：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<period>()
        .Property(p => p.PeriodId)
        .HasColumnType("tinyint unsigned");

    modelBuilder.Entity<perioddate>()
        .Property(pd => pd.PeriodId)
        .HasColumnType("tinyint unsigned");
}

方案2：调整分组查询逻辑 #

先对perioddate按PeriodId分组取最新的PeriodDate1，再关联period表，简化SQL生成逻辑，避免类型转换冲突：

var latestPeriodDates = _context.perioddates
    .GroupBy(pd => pd.PeriodId)
    .Select(g => new 
    { 
        PeriodId = g.Key, 
        LatestDate = g.Max(pd => pd.PeriodDate1) 
    });

var periodList = (from pd in _context.perioddates
                  join lp in latestPeriodDates on pd.PeriodId equals lp.PeriodId
                  where pd.PeriodDate1 == lp.LatestDate
                  join p in _context.periods on pd.PeriodId equals p.PeriodId
                  select new 
                  { 
                      p.PeriodId, 
                      p.Period1, 
                      p.PeriodName, 
                      pd.PeriodDate1 
                  }).ToList();

方案3：调整模型字段类型 #

如果显式配置映射无效，可以尝试将模型中的PeriodId从byte改为ushort（对应MySQL的SmallInt Unsigned），利用驱动对ushort更稳定的处理逻辑避免转换错误：

// period模型修改
public ushort PeriodId { get; set; } // TinyInt Unsigned 改用ushort映射

// perioddate模型修改
public ushort PeriodId { get; set; } // Tiny int 改用ushort映射

修改后需确保数据库字段与模型类型匹配，必要时更新迁移。

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