MySQL 8.0.2+才完整支持窗口函数；低于该版本（如8.0.1）调用RANK()等会报错；需检查VERSION()和sql_mode，且窗口函数不能在WHERE中引用。
MySQL 8.0 的窗口函数功能默认开启，无需额外配置——但前提是版本 ≥ 8.0.2 且未启用禁用窗口函数的 SQL 模式。
确认 MySQL 版本是否真正支持窗口函数
很多问题其实卡在“以为自己用的是 8.0，实际是 8.0.1 或更低”。SELECT VERSION() 返回的结果必须是 8.0.2 或更高（如 8.0.33），低于该版本的 8.0.x（例如 8.0.1）不完整支持标准窗口函数，RANK()、DENSE_RANK() 等会报 FUNCTION RANK does not exist。
常见错误现象：
- 执行
SELECT RANK() OVER (ORDER BY id) FROM t;报错You have an error in your SQL syntax，但语句明显合法 -
SHOW VARIABLES LIKE 'version%';显示8.0.1—— 这就是根源
解决办法：
- 升级 MySQL Server 到 8.0.2+（推荐 8.0.33 或 LTS 版本）
- 避免使用社区版中极早期的 8.0 快照包（如某些 Docker 镜像 tag 写着 “8.0” 实际是 8.0.0）
检查并临时绕过限制性 SQL 模式
即使版本达标，sql_mode 中若包含某些兼容性设置（如旧版遗留的 ONLY_FULL_GROUP_BY 在特定嵌套下可能干扰推导，或自定义模式误加了禁用项），也可能导致窗口函数不可用。
执行 SELECT @@sql_mode; 查看当前会话模式。若输出中含非常规项（如 STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION,TRADITIONAL 等组合），建议先临时清空测试：
- 运行
SET sql_mode = ''; - 再试一个简单窗口查询，如
SELECT name, salary, ROW_NUMBER() OVER (ORDER BY salary DESC) FROM employees LIMIT 5; - 若成功，说明原
sql_mode干扰了窗口函数解析；后续应按需精简模式，而非长期设为空
WHERE 子句中无法直接引用窗口函数结果
这是最常踩的坑：窗口函数在 SQL 执行顺序中晚于 WHERE，所以以下写法一定报错 Unknown column 'rn'：
SELECT *, ROW_NUMBER() OVER (PARTITION BY dept ORDER BY salary DESC) AS rn FROM employees WHERE rn <= 3;
正确做法只有两种：
- 用 CTE：
WITH ranked AS (SELECT *, ROW_NUMBER() OVER (...) AS rn FROM employees) SELECT * FROM ranked WHERE rn - 用派生表（子查询）：
SELECT * FROM (SELECT *, ROW_NUMBER() OVER (...) AS rn FROM employees) t WHERE t.rn
注意：PARTITION BY 和 ORDER BY 在多数排名函数中是必需的，漏掉 ORDER BY 会导致结果不可预测（如 ROW_NUMBER() 行号随机）。
客户端连接与驱动兼容性问题
窗口函数本身是服务端能力，但老版本客户端（如 Navicat 12 以下、MySQL Workbench 6.x、某些 JDBC 驱动 5.1.x）可能因协议解析缺陷，无法正确处理含 OVER 的语句，表现为连接后执行即断开或返回空结果。
验证方式：
- 先在命令行用
mysql -u root -p直连执行窗口查询，确认服务端无问题 - 若命令行正常而 GUI 工具失败，升级客户端：Navicat ≥ 15，Workbench ≥ 8.0，JDBC 驱动 ≥ 8.0.28
- Windows 下若遇到认证插件不兼容（如报
Client does not support authentication protocol），需在my.cnf中添加：default_authentication_plugin=mysql_native_password，并重启 MySQL
窗口函数的“可用”不是开关式配置，而是版本、模式、语法、客户端四者共同决定的链路；其中任意一环断裂，都会让 RANK() 变成报错符号。
