跨月统计报表必须先生成完整月份序列再左关联业务表，避免漏月；用with recursive生成连续月份序列（mysql 8.0+），需设cte_max_recursion_depth、起始日为当月1日，并用month_start >= in_start and month_start
跨月统计报表在存储过程中不能靠 GROUP BY MONTH(create_time) 硬凑——它会漏掉没数据的月份，导致折线图断层、同比计算错位。必须先生成完整月份序列，再左关联业务表。
用 WITH RECURSIVE 生成连续月份序列（MySQL 8.0+）
这是最干净的做法，执行计划稳定、代码可读性强，且天然支持参数化起止时间。
- 递归深度默认限制为 1000，跨年统计（如 24 个月）需提前设
SET SESSION cte_max_recursion_depth = 100; - 起始日期必须是当月 1 日（
DATE_FORMAT(in_start, '%Y-%m-01')），否则递归可能多算或少算一行 - 终止条件用
WHERE month_start >= in_start AND month_start 比字符串比较更安全，避免时区或格式歧义 - 示例片段：
WITH RECURSIVE month_series AS ( SELECT DATE_FORMAT(in_start, '%Y-%m-01') AS month_start UNION ALL SELECT DATE_ADD(month_start, INTERVAL 1 MONTH) FROM month_series WHERE month_start <h3> <code>GROUP BY</code> 前必须处理 NULL 和聚合逻辑错位</h3> <p>LEFT JOIN 后直接 <code>COUNT(*)</code> 会把无订单月份计为 0 行，但实际返回的是 NULL；而 <code>COUNT(o.order_id)</code> 才真正统计该月订单数。</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/ai/1057" title="Aiva.ai"><img src="https://img.php.cn/upload/ai_manual/001/503/042/68b6ca6565a86158.png" alt="Aiva.ai" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/ai/1057" title="Aiva.ai" class="overflowclass">Aiva.ai</a> <p class="overflowclass">Aiva.ai是一款用于生成多风格原创曲目的 AI 音乐作曲助手。</p> </div> <a rel="nofollow" href="/ai/1057" title="Aiva.ai" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>
-
COUNT(*)统计结果集行数（含左表空匹配行），COUNT(字段)只统计非 NULL 字段值——这是跨月统计里最常踩的坑 - 聚合字段若含 NULL，
SUM()和AVG()默认忽略，但报表常需显示 0，得用COALESCE(SUM(amount), 0) - 别在
WHERE里写o.create_time IS NOT NULL——这会把无数据月份过滤掉，破坏序列完整性
存储过程里传参控制统计粒度（避免硬编码）
不同报表要按「年+月」「季度」「自然周」切分，不能每个都写一个存储过程。用输入参数驱动分组逻辑更可持续。
- 用
IN period_type VARCHAR(10)控制分组方式：'month'→DATE_FORMAT(o.create_time, '%Y-%m')，'quarter'→CONCAT(YEAR(o.create_time), '-Q', QUARTER(o.create_time)) - 动态拼接
GROUP BY表达式时，务必校验参数值（IF period_type NOT IN ('month','quarter','year') THEN SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'Invalid period_type';） - 注意 MySQL 对表达式别名的限制：
GROUP BY必须写完整表达式，不能只写AS report_period
大表跨月统计的性能雷区
千万级订单表直接 LEFT JOIN 12 行月份序列，仍可能触发全表扫描——关键不在序列长度，而在关联字段是否走索引。
- 确保业务表上有
INDEX (create_time)或组合索引INDEX (create_time, status)（如果带状态过滤） - 避免在
ON条件里对字段函数化：DATE_FORMAT(o.create_time, '%Y-%m') = ms.month_str会让索引失效；应改用范围查询：o.create_time >= ms.month_start AND o.create_time - 若统计口径固定（如每月销售总额），考虑用物化视图或预计算汇总表，存储过程只查汇总表，而非原始明细
跨月统计真正的难点不在生成序列，而在让关联不丢月份、聚合不歪数据、参数不破索引——每一步都得盯着执行计划里的 type 和 key 列验证。
