mysql 8.0.2及以上版本才完整支持窗口函数；低于该版本（如5.7或8.0.1）因缺失语法解析与执行引擎，会直接报error 1064，需通过select version()和进程验证确认真实版本。
确认窗口函数是否被真正支持
报错位置在 OVER、PARTITION BY 或函数名（如 FIRST_VALUE）附近，大概率不是语法写错，而是 MySQL 根本没识别这个语法——说明版本低于 8.0，或实际运行的不是你认为的那个实例。执行 SELECT VERSION(); 看返回值；若显示 5.7.33 或 8.0.1，那就对了：前者完全不支持，后者部分函数不可用。别信“装了 MySQL 8.0”这种说法，要查进程和 socket 路径，用 ps aux | grep mysql 和 mysql -S /tmp/mysql.sock -e "SELECT VERSION();" 双重验证。
检查字段名与关键字拼写硬伤
这类错误常被忽略，但直接触发 ERROR 1064。比如把 regdate 写成 regdata，把 PARTITION BY 手误打成 PARTION BY，或者在 DATE_FORMAT() 里混用单引号嵌套（如 DATE_FORMAT(regdate, '%Y-%m') 没问题，但若外层再套一层字符串且用了单引号，解析器可能提前截断）。重点检查：
-
OVER前后有没有多余空格或不可见字符（尤其从 Excel 或微信粘贴过来的 SQL） - 所有列名用
DESCRIBE table_name;对一遍，确认大小写和下划线 - 避免在
ORDER BY子句中使用表达式别名（如AS ym），必须写原始表达式DATE_FORMAT(regdate, '%Y-%m')
WHERE 中不能直接引用窗口函数结果
这是最隐蔽也最常复现的逻辑错误。例如想查每个部门工资最高的员工，写成：
SELECT dept, name, salary, RANK() OVER (PARTITION BY dept ORDER BY salary DESC) AS rk FROM employees WHERE rk = 1;
会报 Unknown column 'rk' ——因为窗口函数在 SQL 执行顺序中晚于 WHERE。正确做法只有两种：
- 用 CTE 包一层：
WITH ranked AS (SELECT *, RANK() OVER (...) AS rk FROM employees) SELECT * FROM ranked WHERE rk = 1; - 或用派生表：
SELECT * FROM (SELECT *, RANK() OVER (...) AS rk FROM employees) t WHERE t.rk = 1;
别试图加 HAVING 替代，它只作用于聚合结果，对窗口函数无效。
索引与排序字段不匹配导致隐性失败
查询没报错但性能崩了，可能是窗口函数拖慢了整个语句。比如 OVER (PARTITION BY user_id ORDER BY create_time DESC)，若表上只有 user_id 单列索引，MySQL 无法高效完成分区内排序，会回表 + filesort。这时 EXPLAIN 显示 Using temporary; Using filesort 就是信号。修复方式很实在：
- 建复合索引：
ALTER TABLE logs ADD INDEX idx_user_time (user_id, create_time DESC); - 注意：MySQL 8.0 支持降序索引，但低版本会忽略
DESC关键字，只建升序 - 如果
ORDER BY是表达式（如DATE_FORMAT(create_time, '%Y-%m')），索引无效，得改用生成列 + 函数索引
香港、新加坡等高延迟机房的 VPS 上这个问题更明显，临时表 IO 增幅可达 3 倍，不能只看语法对不对。
