MySQL INFORMATION_SCHEMA.KEYWORDS 怎样判断字段名是否撞关键字
表结构迁移时,字段名看起来只是普通英文单词,执行 CREATE TABLE 或 ALTER TABLE 却突然报语法错误,常见原因不是字段类型,而是这个名称被 MySQL 当成了关键字。判断时不要只凭记忆维护一份“禁用词名单”,MySQL 8.4 提供了运行时可查询的 INFORMATION_SCHEMA.KEYWORDS 表。
官方地址:https://dev.mysql.com/doc/refman/8.4/en/information-schema-keywords-table.html
把候选字段名与KEYWORDS.WORD做不区分大小写的匹配,再看RESERVED:返回 1 表示保留字,返回 0 表示非保留关键字;没有匹配行则说明它不在这张运行时关键字表中。
迁移为什么会在字段名处失败
一次迁移失败通常表现为:业务代码已经把字段名写入模型,数据库变更脚本却在建表或加列时停住。此时只看错误消息中的语法位置,容易把注意力放到逗号、括号或类型上;真正应该先确认的是,出错位置是否正好落在一个未引用的标识符上。
关键字和保留字不是完全相同的概念。KEYWORDS 表会列出 MySQL 识别的单词,并用 RESERVED 列标出是否为保留字。保留字在某些上下文中需要特殊引用;非保留关键字不一定立即导致语法错误,但仍值得避开,因为 SQL 可读性和跨版本兼容性会变差。

先查询候选字段名是否在关键字表中
把要加入表结构的名称放进变量,再查询 WORD 和 RESERVED。示例使用 rank 作为待检查名称,重点是查询方法,不是预先断言某个版本中的具体结果。
-- 把迁移脚本里的候选字段名放进变量,便于替换和复用查询。
SET @identifier = 'rank';
SELECT
WORD,
RESERVED
FROM INFORMATION_SCHEMA.KEYWORDS
WHERE UPPER(WORD) = UPPER(@identifier);
如果返回一行,WORD 是 MySQL 识别到的关键字;RESERVED 为 1 时,说明它是保留字,为 0 时说明它是非保留关键字。如果没有返回行,当前实例的这张运行时表没有把该字符串列为关键字。
查询时使用 UPPER 是为了让检查意图明确:字段名在 SQL 中常以小写、首字母大写或全大写出现在不同代码库里,而关键字表中的展示形式不应成为迁移脚本的隐含前提。
看到 RESERVED=1 后应该怎样处理
保留字命中后有两条路:长期方案是改成业务含义更清楚、且不容易与 SQL 语法混淆的名称;短期兼容方案是在标识符位置使用反引号,并同时修改查询、索引、ORM 映射和迁移回滚脚本。不要把反引号当作“这个名字从此安全”的证明,它只是当前 SQL 文本中的引用方式。
-- 使用反引号只保护标识符位置,字符串值仍然使用单引号。
CREATE TABLE account_score (
`rank` INT NOT NULL,
score DECIMAL(10, 2) NOT NULL
);
-- 查询被引用的字段时,反引号仍然只出现在标识符位置。
SELECT `rank`, score
FROM account_score;
如果团队可以控制新表结构,建议把 rank 改成 ranking_position、display_rank 这类表达业务语义的名称。改名会影响应用层字段、索引定义、报表 SQL 和数据同步脚本,因此应该在同一个变更单里完成,而不是只修复第一条报错。
把单个查询变成迁移前的检查
真正容易漏掉的不是已经失败的字段,而是下一张表里的新字段。可以在迁移前把候选名称整理成临时表,再与 KEYWORDS 关联;这样一次能看到哪些名称命中、哪些命中项是保留字。
-- 临时表保存本次迁移准备新增的字段名,避免把名称直接拼接进 SQL。
CREATE TEMPORARY TABLE migration_identifiers (
identifier_name VARCHAR(64) NOT NULL
);
INSERT INTO migration_identifiers (identifier_name)
VALUES ('rank'), ('display_name'), ('window');
-- 用大小写不敏感的比较找出关键字,并把保留状态带回检查结果。
SELECT
m.identifier_name,
k.WORD,
k.RESERVED
FROM migration_identifiers AS m
LEFT JOIN INFORMATION_SCHEMA.KEYWORDS AS k
ON UPPER(k.WORD) = UPPER(m.identifier_name)
ORDER BY m.identifier_name;
这里用 LEFT JOIN 保留没有命中的名称:结果中 WORD 和 RESERVED 为 NULL,表示它没有在关键字表中匹配到记录。检查脚本可以据此把命中项交给人工命名评审,而不是让数据库在发布时才给出语法错误。

为什么不能把关键字名单写死在项目里
关键字与保留状态是 MySQL 实例运行时提供的信息。不同版本、SQL 能力和迁移目标可能让一份旧名单失去参考价值,因此更稳妥的做法是:在目标数据库上执行检查,保存迁移审查结果,再决定是否改名或引用。
还要区分三种对象:
| 检查结果 | 含义 | 建议 |
|---|---|---|
有记录,RESERVED=1 | 关键字中的保留字 | 优先改名;无法改名时在所有标识符位置统一引用 |
有记录,RESERVED=0 | 非保留关键字 | 当前语句可能可用,但新设计仍建议避开语法词 |
| 没有记录 | 不在当前 KEYWORDS 表中 | 继续检查长度、字符集、命名规范与业务冲突 |
最后不要只检查建表语句。字段名还会出现在查询、排序、索引、视图、触发器和 ORM 生成 SQL 中;如果采用反引号方案,必须让这些位置保持一致,否则“建表成功”仍可能在读写阶段再次失败。
常见问题
没有查到记录,是否代表这个字段名永远安全?
不是。它只表示当前实例的 INFORMATION_SCHEMA.KEYWORDS 没有匹配到该名称,还需要检查标识符长度、字符集、命名规范以及目标 SQL 语句的上下文。
非保留关键字可以直接作为字段名吗?
当前语句可能可以,但新表设计通常应避开关键字。这样能减少读者误解,也能降低未来升级或迁移到其他数据库时的改造成本。
用反引号后还要改 ORM 字段名吗?
如果 ORM 生成 SQL 时不会自动正确引用,仍然要改映射或改数据库字段名。数据库里的反引号不会自动改变应用代码中的字段属性和查询模板。
排查字段名冲突时,先在目标 MySQL 实例查询 INFORMATION_SCHEMA.KEYWORDS,再根据 RESERVED 决定改名还是统一引用。这样可以把迁移错误从“发布时才发现”提前到结构设计和审查阶段。
MySQL JSON_REMOVE 怎样一次删除多个路径
- 上一篇
- MySQL JSON_REMOVE 怎样一次删除多个路径
- 下一篇
- MySQL CHECK 约束怎样处理历史脏数据迁移
-
- 数据库 · MySQL | 13分钟前 | MySQL · 性能优化 · binlog · 主从复制 · mysql 二进制日志 binlog_row_image binlog_format 行复制
- MySQL binlog_row_image 怎样选择行事件包含的列
- 244浏览 收藏
-
- 数据库 · MySQL | 14分钟前 | MySQL · 事务 · mysql 行锁 NOWAIT SKIP LOCKED
- MySQL NOWAIT 和 SKIP LOCKED 有什么区别
- 315浏览 收藏
-
- 数据库 · MySQL | 18分钟前 | MySQL · mysql group_concat group_concat_max_len
- MySQL GROUP_CONCAT 怎样控制结果长度和排序
- 152浏览 收藏
-
- 数据库 · MySQL | 31分钟前 | MySQL · mysql 数组下标 JSON路径 JSON_REMOVE 多个路径
- MySQL JSON_REMOVE 怎样一次删除多个路径
- 121浏览 收藏
-
- 数据库 · MySQL | 33分钟前 | MySQL · 数据库 · mysql IPv6 hex INET6_ATON INET6_NTOA VARBINARY 二进制地址
- MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
- 266浏览 收藏
-
- 数据库 · MySQL | 33分钟前 | MySQL · mysql 窗口函数 ROW_NUMBER 每组第一行
- MySQL 窗口函数怎样保留每组排名第一行
- 230浏览 收藏
-
- 数据库 · MySQL | 50分钟前 | MySQL · mysql SOUNDEX 多字节字符 SOUNDS LIKE 中文姓名 近音匹配
- MySQL SOUNDEX 为什么不适合中文姓名近音匹配
- 366浏览 收藏
-
- 数据库 · MySQL | 59分钟前 | MySQL · 压缩 · 数据存储 · mysql compress VARBINARY UNCOMPRESSED_LENGTH UNCOMPRESS 短字符串压缩
- MySQL COMPRESS 为什么会让短字符串占用更多字节
- 338浏览 收藏
-
- 数据库 · MySQL | 15小时前 |
- MySQL INFORMATION_SCHEMA.TABLESPACES_EXTENSIONS 怎样读取表空间的引擎扩展属性
- 214浏览 收藏
-
- 数据库 · MySQL | 16小时前 |
- MySQL session_account_connect_attrs 怎样理解账户范围内的连接属性可见性
- 111浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1110次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1101次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1273次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1215次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1062次使用
-
- MySQL 明明加了索引,为什么查询还是很慢?先查这 6 个点
- 2026-06-27 374浏览
-
- 接口返回的数据和数据库不一致怎么办?按数据生命周期排查
- 2026-06-27 398浏览
-
- golang MySQL实现对数据库表存储获取操作示例
- 2022-12-22 499浏览
-
- golang 基于 mysql 简单实现分布式读写锁
- 2023-01-07 384浏览
-
- 详解如何利用GORM实现MySQL事务
- 2023-01-07 184浏览

