EF Core LINQ分组查询如何补全无支付记录的月份数据？

可以通过生成目标时间范围内的全量年月序列，再和原统计结果做左连接的方式补全无支付记录的月份分组，具体实现步骤如下：

1. 生成指定时间范围的所有年月序列 #

先写一个方法，输出从起始年月到结束年月的所有年月组合：

private IEnumerable<(int Year, int Month)> GetAllMonthsInRange(DateTime startDate, DateTime endDate)
{
    var currentMonth = new DateTime(startDate.Year, startDate.Month, 1);
    var lastMonth = new DateTime(endDate.Year, endDate.Month, 1);
    
    while (currentMonth <= lastMonth)
    {
        yield return (currentMonth.Year, currentMonth.Month);
        currentMonth = currentMonth.AddMonths(1);
    }
}

2. 修改统计逻辑，补全空月份 #

原代码只能统计有支付记录的月份，我们需要先获取数据库中的统计结果，再和全量年月序列做左连接，将无匹配的月份计数设为0：

private IEnumerable<ChartItem> GetByMonthWithEmptyMonths(IQueryable<Payment> data)
{
    // 方式1：自动获取数据覆盖的时间范围
    var minPaymentDate = data.Min(p => p.CreateDate);
    var maxPaymentDate = data.Max(p => p.CreateDate);
    
    // 方式2：手动指定固定范围（比如最近12个月）
    // var minPaymentDate = DateTime.Now.AddMonths(-11);
    // var maxPaymentDate = DateTime.Now;
    
    // 生成全量年月列表
    var allMonths = GetAllMonthsInRange(minPaymentDate, maxPaymentDate);
    
    // 从数据库获取已有支付记录的月度统计（先拉到内存）
    var existingMonthlyStats = data
        .GroupBy(p => new { p.CreateDate.Year, p.CreateDate.Month })
        .Select(g => new 
        {
            g.Key.Year,
            g.Key.Month,
            PaymentCount = g.Count()
        })
        .ToList();
    
    // 左连接补全空月份
    var fullStats = from month in allMonths
                    join stat in existingMonthlyStats
                        on new { month.Year, month.Month } equals new { stat.Year, stat.Month } into joinedGroup
                    from matchedStat in joinedGroup.DefaultIfEmpty()
                    orderby month.Year, month.Month
                    select new ChartItem
                    {
                        X = $"{month.Month}-{month.Year}",
                        Y = matchedStat?.PaymentCount ?? 0
                    };
    
    return fullStats;
}

关键说明 #

• EF Core无法直接在数据库层面生成全量年月序列，因此需要先把统计结果加载到内存，再和内存中的年月序列做连接——年月序列数据量极小（几十年仅几百条），不会造成性能问题。
• 可以根据需求切换时间范围的获取方式：自动匹配数据的时间跨度，或者手动指定固定范围（比如最近N个月）。
• 如果需要调整X轴的日期格式（如"2024-05"），直接修改X属性的拼接逻辑即可。

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