// MySQL 错误参考

MySQL 错误 1064:你的 SQL 语法有错误

MySQL 无法解析该语句。near 后面的文本显示解析停止的位置;错误通常就在此处或其之前。

错误编号
1064
名称
ER_PARSE_ERROR
SQLSTATE
42000
类别
语法和语句
错误信息
%s near '%s' at line %d

它的意思

1064 是解析错误。参考消息的格式为 %s near '%s' at line %d,其中第一部分是通用文本 You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use,引号里是从解析器放弃之处开始的 SQL,行号从语句开头算起。

解析器在无法匹配的第一个标记处停止,因此真正的错误通常是引号文本之前的标记:缺少逗号、未闭合的引号或将保留字用作名称。

常见原因

  • 保留字未加反引号就用作表名或列名,例如 order, group, key 或者 rank (自 8.0 起为保留字)。
  • 缺少或多余的逗号、括号或引号。
  • 来自其他数据库的语法: TOP, [brackets], ISNULL() 来自 SQL Server,或 :: 类型转换和 RETURNING 来自 PostgreSQL。
  • 比服务器更新的语法,例如 MySQL 5.7 上的窗口函数或 CTE。
  • 包含 DELIMITER 或经由不理解的驱动程序发送的存储程序主体 DELIMITER (这是 mysql 客户端命令,不是 SQL)。

如何修复它

  1. 查看其后面带引号的文本 near 之后的引号内容以及它前面的标记。如果引号内容为空(near ''),说明语句过早结束,通常是引号或括号未闭合。

  2. 对作为保留字的标识符,用反引号括起来。

    SELECT `order`, `rank` FROM `group` WHERE `key` = 1;
  3. 在使用较新语法前检查服务器版本。

    SELECT VERSION();
  4. 重写其他方言的语法: LIMIT 代替 TOP、用反引号代替方括号、 CAST(x AS ...) 代替 ::.

安全地复现它

SELECT * FROM orders WHERE id = 1 ORDER date;
-- ERROR 1064 (42000): You have an error in your SQL syntax; ... near 'date' at line 1

相关错误

更多语法和语句错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。