// 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 以及它前面那個 token。如果引起來的文字是空的(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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。