您现在的位置：程式碼之家 >> 數據庫知識 > >> MySQL 資料庫 >> MySQL 綜合教學

MyCat 1.5~1.6 checkSQLschema Bug：點號字串被誤解析

編輯：MySQL 綜合教學

MyCat 1.5~1.6 checkSQLschema Bug：點號字串被誤解析

MyCat 作為資料庫中間件，開啟 checkSQLschema="true" 可攔截跨分片查詢，但在 1.5~1.6 版本中存在解析缺陷：WHERE 條件中的字串字面值若包含點號 .，會被錯誤移除。

問題重現

正常 SQL (MySQL 直連執行成功)

SELECT * FROM device 
WHERE devicetype = 'AMS.Monitoring.XlCloud.QKL8154.XLCloudDevice';

MyCat 開啟 checkSQLschema 後

# schema.xml

    EXPLAIN 顯示被改寫為
SELECT * FROM device 
WHERE devicetype = 'AMS.XlCloud.QKL8154XLCloudDevice';
# 少了 Monitoring. 且 QKL8154.XLCloudDevice 變成 QKL8154XLCloudDevice
根因分析
MyCat 的 SQL 解析器 (基於 Cobar/Alibaba SQL Parser) 在 checkSQLschema 模式下，會嘗試解析 SQL 結構以判斷分片鍵。其 Tokenizer 錯誤地將字串字面值內的點號視為「識別符分隔符」 (如 table.column)，導致字串內容被破壞。
臨時解決方案：字串轉義點號
SELECT * FROM device 
WHERE devicetype = 'AMS\.Monitoring\.XlCloud\.QKL8154\.XLCloudDevice';
在 MyCat 解析層面，反斜線轉義後的點號不再被視為分隔符，SQL 可正確路由。
影響範圍與風險















  場景 是否受影響 說明
  WHERE 字串含點號 ✅ 是 如 URL、FQDN、版本號、JSON 路徑
  WHERE 字串含其他標點 ❌ 否 底線、連字號、冒號等正常
  數值/日期比較 ❌ 否 無字串字面值
  JOIN ON 條件 ⚠️ 可能 若 ON 子句含字串常數
  INSERT VALUES ⚠️ 可能 VALUES 字串含點號


升級建議

  升級至 MyCat 1.6.7+ 或 2.x：官方已修復該 Tokenizer Bug。
  若無法升級：應用層統一轉義點號，或關閉 checkSQLschema (失去跨分片保護)。
  測試驗證：上線前跑全量 SQL 測試套件，專門測試含點號字串的查詢。


配置最佳實務
# schema.xml 建議配置

    
    相關 Issue 追蹤

  GitHub: MyCat Tokenizer incorrectly strips dots in string literals
  Gitee: checkSQLschema 導致點號丟失
中間件解析器 Bug 極難排查，建議在測試環境建立「含特殊字元字串」的回歸測試集，覆蓋點號、引號、反斜線、Unicode 等邊界情況。
 
 

							上一篇文章： MySQL 遞迴查詢：樹狀結構子樹查詢完整解決方案 
下一篇文章： SQL 行轉列 (Pivot) 實戰：CASE 聚合法完整教學 
						

					
						MySQL 綜合教學
						
					
					
						
						
							
							MySQL 獲取系統當前時間函數：NOW、CURDATE、CURTIME 完整對比
							MySQL 提供三大核心函數獲取當前日期時間，各有適用場景與			
						
						
						
							
							如何查看與修改 MySQL 數據庫字符集編碼：完整操作指南
							查看當前字符集設置

進入 MySQL 客戶端：

cd C			
						
						
						
							
							MySQL 增量備份完整實戰：二進制日誌開啟、位置/時間點恢復、binlog 管理與自動化策略
							MySQL 增量備份依賴二進制日誌，記錄所有 DDL/DML			
						
						
						
							
							俄羅斯反壟斷機構有條件批准 Oracle 併購 Sun：必須持續開發 MySQL
							審查結果
俄羅斯聯邦反壟斷局（FSA）批准 Oracle 以			
						
						
						
					
				

				
				 	
				
					
						
					
					
						
						MySQL 雙向複寫技術完整實戰指南
						
						MySQL 時間範圍查詢兩大高效寫法：傳統 BETWEEN vs UNIX 時間戳優化
						
						MySQL 連接與基礎信息檢查命令速查手冊
						
						MySQL 中文亂碼完整解決方案：從字元集設定到連線參數
						
						MySQL 匯入報錯 "Got a packet bigger than max_allowed_packet" 兩種解決方案
						
						MySQL去重利器：DISTINCT 與 GROUP BY 異同與選型指南
						
						C++ 連線 MySQL 實戰總結（API 方式、VS 專案配置、64 位元坑點）
						
					
				
			
				
					欄目導航
					
						MySQL 入門
SQL 基礎
MySQL 資料庫相關知識
MariaDB 資料庫
MySQL 綜合教學
					
					
				
			
Copyright © 程式碼之家 All Rights Reserved

場景	是否受影響	說明
WHERE 字串含點號	✅ 是	如 URL、FQDN、版本號、JSON 路徑
WHERE 字串含其他標點	❌ 否	底線、連字號、冒號等正常
數值/日期比較	❌ 否	無字串字面值
JOIN ON 條件	⚠️ 可能	若 ON 子句含字串常數
INSERT VALUES	⚠️ 可能	VALUES 字串含點號