讲师中心 微信公众号
AI工具推荐 视频效率加速

mysql升级过程中处理SQL兼容性与语法变动问题

冬明同学_2418

冬明同学_2418

发布时间:2026-01-14 09:13:02

|

658人浏览过

|

来源于php中文网

原创

MySQL 8.0升级后GROUP BY报错源于默认启用ONLY_FULL_GROUP_BY模式,需重写SQL使SELECT列全在GROUP BY中或用聚合函数包裹,而非简单关闭该模式。

mysql升级过程中处理sql兼容性与语法变动问题

MySQL 8.0 升级后 GROUP BY 报错:Expression #1 of SELECT list is not in GROUP BY clause

这是升级到 MySQL 8.0 后最常遇到的报错,根源是默认启用了 sql_mode=ONLY_FULL_GROUP_BY。旧版本(如 5.7)即使关闭该模式也可能因配置遗漏而“侥幸通过”,但 8.0 默认严格校验。

  • 检查当前模式:
    SELECT @@sql_mode;
    确认是否含 ONLY_FULL_GROUP_BY
  • 临时绕过(仅测试环境):
    SET SESSION sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';
  • 长期方案不是关掉它,而是重写 SQL:所有 SELECT 列必须在 GROUP BY 中显式出现,或用聚合函数包裹,例如:
    SELECT user_id, MAX(name), COUNT(*) FROM orders GROUP BY user_id;
    而非 SELECT user_id, name, COUNT(*) FROM orders GROUP BY user_id
  • 注意 ORM 框架(如 Django、MyBatis)自动生成的 SQL 可能隐含非确定性字段,需配合框架配置或手动重写查询

mysql_native_password 认证插件被弃用导致连接失败

MySQL 8.0 默认使用 caching_sha2_password 插件,老客户端(尤其是 MySQL 5.7 客户端、某些 JDBC 驱动旧版、PHP mysqli 扩展)不支持,会报错 Client does not support authentication protocol requested by server。

Json Schema Toolkit
Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载
  • 确认用户认证方式:
    SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user';
  • 降级插件(兼容性优先):
    ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password'; FLUSH PRIVILEGES;
  • 更推荐升级客户端驱动:JDBC 用 mysql-connector-java:8.0.28+,Python 用 PyMySQL >= 1.0.2 或 mysqlclient >= 2.1.0,并确保连接字符串中指定 ?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false(视环境而定)
  • 不要在生产环境全局修改 default_authentication_plugin,只针对具体用户调整

系统表、保留字与函数行为变更引发隐性错误

MySQL 8.0 新增大量保留字(如 ROLE、RESOURCE_GROUP),且部分内置函数语义收紧,容易在无报错情况下返回错误结果。

  • 检查建表语句中是否误用新保留字作列名或别名,例如:SELECT role FROM users 在 8.0 中需写成 SELECT `role` FROM users
  • JSON_EXTRACT 返回值类型更严格:以前可能自动转为字符串,现在返回 JSON 类型,WHERE JSON_EXTRACT(data, '$.status') = 'active' 应改为 WHERE JSON_UNQUOTE(JSON_EXTRACT(data, '$.status')) = 'active' 或用 ->> 操作符:WHERE data->>'$.status' = 'active'
  • INFORMATION_SCHEMA 表结构有调整(如 TABLES 表新增 CREATE_OPTIONS 字段),依赖硬编码字段顺序的脚本会出错,务必用字段名而非序号访问
  • 执行 mysqldump --compatible=mysql40 不再能解决语法兼容问题,应改用 --skip-triggers --no-create-info 分离逻辑,人工校验触发器和 DDL

升级前必须做的 SQL 兼容性扫描

不能靠“升级后再修”,必须前置识别风险点。官方 mysqlsh 的 util.checkForServerUpgrade() 是基础,但覆盖有限;需补充人工规则。

  • 用正则批量扫描 SQL 文件(含应用代码、存储过程、迁移脚本):
    grep -n -E "(GROUP\s+BY.*[^,]\s+[^[:space:]]+[^,]|ORDER\s+BY.*\s+NULLS\s+(FIRST|LAST)|CREATE\s+USER.*IDENTIFIED\s+WITH)" *.sql *.py *.java
  • 重点关注:含 NULLS FIRST/LAST(8.0 支持但旧版不识别)、CREATE USER ... IDENTIFIED WITH(语法存在但插件名不兼容)、未加反引号的保留字、USING BTREE 在分区表中的位置变化
  • 在测试库启用 log_error_verbosity = 3 并开启 general_log,回放业务流量,捕获所有 warning 级别提示——很多兼容性问题只报 warning 不报 error
  • 特别注意时间函数:NOW(3) 在 5.7 是毫秒精度,在 8.0 是微秒精度,若业务依赖固定小数位,需显式截断或改用 SYSDATE(3)
实际升级中最容易被忽略的,是那些没报错、没警告、但结果已变的场景:比如 GROUP BY 隐式排序失效导致分页错乱,或 JSON_CONTAINS 对 null 值处理逻辑变化影响权限判断。必须用真实业务数据做结果比对,不能只看 SQL 是否执行成功。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

3923

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

831

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1029

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5761

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2703

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5740

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7581

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1030

2024.04.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

20

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 178人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 282人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn