PostgreSQL 12+用GENERATE_SERIES生成完整月份序列再左连接业务表补全，MySQL 8.0+用递归CTE模拟，均需统一时区并用DATE_TRUNC对齐月初。
用 GENERATE_SERIES 补全月份（PostgreSQL 12+）
PostgreSQL 12 起原生支持 GENERATE_SERIES，它是补全缺失月份最直接的方式。关键不是先查数据再补，而是先生成完整月份序列，再左连接业务表。
常见错误是试图在 GROUP BY 后用 COALESCE 填空——这没用，缺失的行根本不会出现在结果里。
- 生成月份序列时，
GENERATE_SERIES的起止时间必须覆盖你关心的完整区间，不能只取表中MIN(date)和MAX(date)，否则新插入但未被查询覆盖的月份仍会丢失 - 日期字段需先转为
DATE_TRUNC('month', date_col)统一到月初，否则和生成的月份对不上 - 连接条件要写成
ON series.month = DATE_TRUNC('month', t.created_at)，而不是模糊的EXTRACT(YEAR FROM ...)+EXTRACT(MONTH FROM ...)拼接，后者性能差且易出错
SELECT
s.month,
COALESCE(COUNT(t.id), 0) AS cnt
FROM GENERATE_SERIES(
'2023-01-01'::DATE,
'2023-12-01'::DATE,
'1 month'
) AS s(month)
LEFT JOIN orders t
ON s.month = DATE_TRUNC('month', t.order_date)
GROUP BY s.month
ORDER BY s.month;
MySQL 8.0+ 用递归 CTE 模拟月份序列
MySQL 没有 GENERATE_SERIES，但 8.0+ 支持递归 CTE，可手动构造月份列表。注意：必须显式设置 cte_max_recursion_depth，否则默认只允许 100 层，12 个月没问题，但跨年或多年就可能截断。
- 递归锚点（anchor）必须是具体日期字面量，比如
DATE '2023-01-01'，不能是子查询结果，否则 MySQL 报Recursive reference to CTE 'months' is not allowed -
DATE_ADD步进要用INTERVAL 1 MONTH，别用INTERVAL 30 DAY——后者在 1 月 31 日加 30 天会跳到 3 月 2 日，破坏月份对齐 - 左连接后记得用
IFNULL(COUNT(...), 0)，MySQL 的COALESCE在聚合上下文中有时行为不一致
master..spt_values
- 用
TOP (12)控制生成数量，避免无限递归；起始月份必须用DATEFROMPARTS或CAST显式构造，防止隐式转换引入时区或格式歧义 - 连接时务必用
YEAR(date_col) * 100 + MONTH(date_col)或FORMAT(date_col, 'yyyyMM')对齐，别依赖CONVERT(VARCHAR, date_col, 102)这类带日的格式 - 如果业务表数据量大，补全逻辑应放在视图或 CTE 中，避免每次查询都重算月份序列
WITH months AS (
SELECT TOP (12)
DATEFROMPARTS(2023, ROW_NUMBER() OVER (ORDER BY (SELECT NULL)), 1) AS month
FROM master..spt_values
)
SELECT
m.month,
ISNULL(COUNT(o.id), 0) AS cnt
FROM months m
LEFT JOIN orders o
ON YEAR(o.order_date) = YEAR(m.month) AND MONTH(o.order_date) = MONTH(m.month)
GROUP BY m.month
ORDER BY m.month;
补全逻辑放在应用层还是数据库层？
如果只是报表导出且月份跨度固定（如最近 12 个月），在应用层用 Python/JS 生成月份列表再合并数据更灵活；但若涉及复杂聚合（如月均客单价、环比计算）、权限过滤或实时性要求高，必须在 SQL 层完成补全——否则应用层拿到稀疏数据后，自己拼月份容易漏掉边界情况（比如某月只有 1 条记录但被 HAVING COUNT > 1 过滤掉了）。
真正容易被忽略的是时区处理：数据库时区、应用时区、前端展示时区三者不一致时，2023-01-01 在 UTC 是 0 点，在东八区却是前一天 16 点，导致“1 月订单”被分到 12 月桶里。补全前先确认所有日期字段已按统一时区标准化。
