MySQL 8.0/5.7 解决 only_full_group_by 报错及配置调整方法

项目场景：GROUP BY 聚合报错分析

在项目部署或日常开发中，执行包含非聚合列的 SQL 语句时，控制台或服务日志可能抛出如下错误：

Expression #1 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'grades.order_id' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by

该报错的字面含义为：SELECT 列表中的表达式未包含在 GROUP BY 子句中，且该列不是 GROUP BY 列的函数依赖项。简而言之，当前执行的 SQL 语句违反了 ONLY_FULL_GROUP_BY 模式的规定，因此被数据库拒绝执行。

原因分析：版本差异导致的默认行为变更

根据 MySQL 官方文档说明，自 MySQL 5.7.5 起，ONLY_FULL_GROUP_BY 成为 SQL 模式的默认组成部分（此前版本通常不检测函数依赖）。这一变更旨在提高数据的准确性，防止因随意选择非分组列而获得无意义的随机值。对于从旧版本迁移或在代码生成工具中自动生成的复杂查询，这往往会造成兼容性问题。

解决方案：修改 MySQL 配置文件

要解决此问题，最直接的方式是调整服务器端的 SQL 模式配置。请按照以下步骤操作：

第 1 步：定位配置文件

找到 MySQL 的主配置文件路径，通常为：

/etc/mysql/conf.d/mysql.cnf

或者在某些系统中位于 /etc/my.cnf。使用文本编辑器打开该文件：

vim /etc/mysql/conf.d/mysql.cnf

第 2 步：修改 sql_mode 设置

在配置文件中查找 [mysqld] 段落以及 sql_mode 字段。

情况 A：文件中已有 sql_mode 配置

将列表中已有的 ONLY_FULL_GROUP_BY 删除。请注意保留逗号分隔格式，确保其余参数正常连接。

情况 B：文件中没有 sql_mode 配置

请在 [mysqld] 下新增以下配置行：

[mysqld]
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION

注意：上述配置保留了常用的严格模式与零日期处理选项，去除了 ONLY_FULL_GROUP_BY。保存后需重启 MySQL 服务生效。

Docker 环境下 MySQL 8.0+ 的特别注意事项

若在 Docker 容器中部署 MySQL 并沿用上述修改策略，可能会遇到容器反复重启且无法启动的情况。此时查看容器日志：

docker logs -f --tail 10 mysql

常见报错信息如下：

Error while setting value 'STRICT_TRANS_TABLES,...,NO_AUTO_CREATE_USER,...' to 'sql_mode'

错误原因： 自 MySQL 8.0 起，官方正式移除了 NO_AUTO_CREATE_USER 这一 SQL 模式参数。如果在配置文件中保留该参数，MySQL 8.0 解析配置时会直接报错导致服务无法拉起。

修正步骤

在修改 Docker 挂载的配置文件或构建镜像时的 init 脚本时，务必将 NO_AUTO_CREATE_USER 从 sql_mode 字符串中剔除。

推荐用于 MySQL 8.0 的配置写法：

sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

总结

处理 MySQL 5.7+ 的 GROUP BY 报错核心在于理解版本差异带来的默认配置变化。通过编辑 mysql.cnf 去除 ONLY_FULL_GROUP_BY 即可恢复旧版宽松行为；而在面对 MySQL 8.0 或更高版本时，必须同步清理废弃的参数如 NO_AUTO_CREATE_USER，以保证服务的稳定性。以上就是解决 MySQL only_full_group_by 报错及 Docker 配置问题的详细内容，更多关于 MySQL 版本兼容性优化的资料请关注本站其它相关文章！