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

MySQL升级后出现语法错误怎么办_排查系统保留字与兼容模式

冬晨酱_3109

冬晨酱_3109

发布时间:2026-03-24 09:16:01

|

180人浏览过

|

来源于php中文网

原创

MySQL 8.0升级后GROUP BY报错因默认启用ONLY_FULL_GROUP_BY,需确保SELECT字段在GROUP BY中或被聚合函数包裹;JSON函数更严格,路径键名须双引号;mysql_upgrade不处理用户对象依赖;默认认证插件变更导致客户端连接失败。

mysql升级后出现语法错误怎么办_排查系统保留字与兼容模式

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

这是最典型的兼容性断裂点。MySQL 5.7 默认是 ONLY_FULL_GROUP_BY 关闭的,8.0 开启了——不是 bug,是 SQL 标准更严格了。

常见错误现象:ERROR 1055 (42000): Expression #1 of SELECT list is not in GROUP BY clause...

  • 别急着关 SQL 模式,先检查业务 SQL 是否真合规:SELECT 的字段要么在 GROUP BY 中,要么被聚合函数包裹(如 MAX()、COUNT())
  • 如果确认逻辑无误(比如只查单值分组),可临时调整会话级别:执行 SET SESSION sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''));
  • 全局修改要谨慎:编辑 my.cnf,在 [mysqld] 下加 sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_DATE,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"(显式剔除 ONLY_FULL_GROUP_BY)
  • 注意:某些 ORM(如旧版 Django、Laravel Eloquent)生成的 SQL 可能隐含非确定性字段,升级后必须重审查询逻辑

升级后 json_extract() 返回 NULL 或类型异常

MySQL 5.7 的 JSON 函数对路径语法容忍度高,8.0 更严格;同时默认字符集从 utf8 变成 utf8mb4,影响 JSON 字符解析。

常见错误现象:原 JSON_EXTRACT(col, '$.name') 突然返回 NULL,或 JSON_CONTAINS() 失效

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 检查 JSON 字段是否真合法:用 JSON_VALID(col) 验证,很多老数据是字符串伪装 JSON,升级后校验变严
  • 路径表达式必须用双引号包裹键名:错误写法 '$.user.id' → 正确写法 '$.user."id"'(尤其键含数字、短横线时)
  • 避免隐式转换:JSON_EXTRACT() 返回的是 JSON 类型,不是字符串;需要字符串请用 JSON_UNQUOTE(JSON_EXTRACT(...))
  • 表字符集若仍是 utf8,JSON 中 emoji 或生僻字可能被截断,导致解析失败;建议全库升级为 utf8mb4

mysql_upgrade 执行完还是报错:Table doesn't exist 或 Unknown column

这个命令只更新系统表结构和权限表,不处理用户库中的视图、存储过程、触发器等依赖元数据的对象。

常见错误现象:ERROR 1146 (42S02): Table 'mysql.proc' doesn't exist 或自定义视图报 Unknown column 'xxx' in 'field list'

  • 先确认 mysql_upgrade 是否真正成功运行:它会在日志里输出 “Finished upgrading MySQL tables”,没看到就失败了
  • 手动刷新权限表:执行 FLUSH PRIVILEGES;,再检查 mysql.user 表结构是否含新字段(如 password_expired)
  • 重建依赖系统表的视图:比如老视图用了 mysql.proc,而 8.0 已移除该表,改用 information_schema.ROUTINES;需 DROP + CREATE 替换
  • 存储过程/函数中引用了已删除列(如 plugin 列在 mysql.user 中被拆分),必须重写逻辑,不能只靠 mysql_upgrade 自动修复

客户端连不上:Authentication plugin 'caching_sha2_password' cannot be loaded

MySQL 8.0 默认认证插件从 mysql_native_password 换成 caching_sha2_password,但很多老客户端(尤其是 PHP 7.2 以下、MySQL Connector/J 5.x)不支持。

常见错误现象:Client does not support authentication protocol requested by server

  • 临时方案(开发环境可用):创建用户时指定旧插件:CREATE USER 'u'@'%' IDENTIFIED WITH mysql_native_password BY 'p';
  • 长期方案是升级客户端驱动,但要注意:PHP 7.4+、Connector/J 8.0+ 才完整支持新插件
  • 别改全局默认插件(default_authentication_plugin=mysql_native_password),这等于放弃 8.0 的安全增强,且未来版本可能移除该配置项
  • 如果用 Docker,确认镜像 tag 是 8.0 而非 latest——后者可能已是 8.4,认证机制又有变化
事情说清了就结束。真正的难点不在命令怎么敲,而在哪些对象是“隐式依赖系统表”的——视图、触发器、事件、甚至某些分区表达式,它们不会报错直到第一次执行。升级前务必做全量对象扫描。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

PixPix
PixPix Hot

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

DeepSeek

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

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

豆包大模型

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

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

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

4463

2023.10.12

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

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

931

2023.10.27

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

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

1169

2024.02.23

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

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

6421

2024.03.06

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

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

3223

2024.03.06

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

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

6380

2024.04.07

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

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

8721

2024.04.29

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

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

1190

2024.04.29

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

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

共1课时 | 190人学习

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

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