前言

在實(shí)際開發(fā)中，數(shù)據(jù)庫查詢經(jīng)常需要使用正則表達(dá)式（REGEXP）來篩選復(fù)雜條件下的數(shù)據(jù)。然而，一些開發(fā)者在操作中可能會遇到類似以下錯誤：

### Cause: java.sql.SQLSyntaxErrorException: Got error 'parentheses not balanced' from regexp
; bad SQL grammar []; nested exception is java.sql.SQLSyntaxErrorException: Got error 'parentheses not balanced' from regexp

這種問題通常與 SQL 語法有關(guān)，特別是在使用正則表達(dá)式的語句中，括號未正確閉合。本文將詳細(xì)解析此錯誤的成因、排查步驟和解決方法，幫助大家快速定位并修復(fù)類似問題。

一、錯誤的根本原因

從錯誤信息中可以看出，核心問題在于 parentheses not balanced（括號不匹配）。這表明 SQL 語句中使用的正則表達(dá)式包含語法問題，具體可能是以下幾點(diǎn)：

1. 括號沒有正確配對

正則表達(dá)式中括號用于分組和匹配，若出現(xiàn)缺少開括號 ( 或閉括號 ) 的情況，會導(dǎo)致括號不匹配錯誤。

示例錯誤：

SELECT * FROM users WHERE name REGEXP '(John|Jane';

上述表達(dá)式中，( 開始了一個分組，但沒有匹配的 )，導(dǎo)致 SQL 執(zhí)行報錯。

2. 特殊字符未正確轉(zhuǎn)義

在正則表達(dá)式中，括號 ()、中括號 []、花括號 {} 等字符有特殊含義，如果用作普通字符而未正確轉(zhuǎn)義，可能導(dǎo)致括號匹配混亂。

示例錯誤：

SELECT * FROM logs WHERE message REGEXP '[0-9(a-z]';

正則表達(dá)式 [0-9(a-z] 中，[ 開始了一個字符類匹配，但括號和字符范圍的嵌套未閉合，造成語法錯誤。

3. 正則表達(dá)式復(fù)雜度超出數(shù)據(jù)庫支持范圍

不同數(shù)據(jù)庫（如 MySQL、PostgreSQL）對正則表達(dá)式的支持程度不同。某些復(fù)雜的表達(dá)式（如嵌套分組）可能超出數(shù)據(jù)庫引擎的解析能力，導(dǎo)致括號匹配錯誤。

示例錯誤：

SELECT * FROM table_name WHERE column_name REGEXP '((abc)|(def)';

該表達(dá)式中嵌套的分組在某些數(shù)據(jù)庫版本中可能無法正常解析。

二、錯誤排查步驟

在實(shí)際開發(fā)中遇到此類錯誤時，可以按照以下步驟逐步排查：

1. 檢查 SQL 語句的正則表達(dá)式

• 確認(rèn)正則表達(dá)式中的括號是否平衡。
• 檢查是否有遺漏的 ( 或 )，以及是否存在不必要的嵌套。

示例：

-- 錯誤的正則表達(dá)式
SELECT * FROM products WHERE description REGEXP '(new|used';

修正后：

-- 正確的正則表達(dá)式
SELECT * FROM products WHERE description REGEXP '(new|used)';

2. 測試正則表達(dá)式有效性

• 在獨(dú)立的正則測試工具（如 regex101）中驗(yàn)證表達(dá)式是否符合預(yù)期。
• 確認(rèn)括號和其他符號的語法是否符合目標(biāo)數(shù)據(jù)庫的正則表達(dá)式規(guī)則。

3. 檢查動態(tài) SQL 的拼接

如果 SQL 語句是通過代碼動態(tài)生成的，打印出最終生成的 SQL，確保表達(dá)式在代碼邏輯中未被截斷。

示例（Java 中動態(tài)拼接 SQL）：

String regex = "(John|Jane"; // 錯誤的正則表達(dá)式
String sql = "SELECT * FROM users WHERE name REGEXP '" + regex + "'";
System.out.println(sql); // 打印最終的 SQL，確認(rèn)語法錯誤

三、解決方案

針對上述可能的錯誤成因，提出以下解決方案：

1. 修正正則表達(dá)式的語法

確保括號或其他分隔符配對正確。

錯誤：

SELECT * FROM employees WHERE title REGEXP '(Manager|Engineer';

修正：

SELECT * FROM employees WHERE title REGEXP '(Manager|Engineer)';

2. 轉(zhuǎn)義特殊字符

正則表達(dá)式中若需要匹配普通括號 () 或其他特殊字符，需要使用轉(zhuǎn)義字符 \。

示例：

-- 錯誤：未轉(zhuǎn)義括號，導(dǎo)致語法錯誤
SELECT * FROM logs WHERE message REGEXP '(error|log(';

-- 修正：將括號作為普通字符處理
SELECT * FROM logs WHERE message REGEXP '\\(error|log\\(';

注意：在某些編程語言中，如 Java，需要雙重轉(zhuǎn)義 \\( 才能正確傳遞到 SQL。

3. 簡化復(fù)雜的正則表達(dá)式

若正則表達(dá)式過于復(fù)雜，超出數(shù)據(jù)庫的解析能力，可以嘗試拆分查詢條件或使用更簡單的表達(dá)式。

錯誤：

SELECT * FROM orders WHERE order_code REGEXP '((A123)|(B456)';

修正：

-- 拆分為多個簡單條件
SELECT * FROM orders WHERE order_code REGEXP 'A123' OR order_code REGEXP 'B456';

4. 調(diào)整數(shù)據(jù)庫版本

部分舊版本的數(shù)據(jù)庫對正則表達(dá)式的支持不完善，可以考慮升級到支持更廣泛正則語法的版本。

四、最佳實(shí)踐

為了避免類似的錯誤，在開發(fā)中可以遵循以下最佳實(shí)踐：

1. 養(yǎng)成調(diào)試習(xí)慣

在復(fù)雜 SQL 查詢執(zhí)行前，打印并測試語句。可以通過日志或調(diào)試工具查看最終的 SQL 輸出。

2. 使用在線工具驗(yàn)證正則表達(dá)式

通過正則測試網(wǎng)站（如 regex101 或 RegExr），驗(yàn)證正則表達(dá)式是否符合預(yù)期，并確保語法正確。

3. 編寫單元測試

為動態(tài)生成的 SQL 編寫單元測試，確保表達(dá)式在不同條件下生成正確的語句。

示例：

@Test
public void testSqlGeneration() {
    String regex = "(abc|def)";
    String expectedSql = "SELECT * FROM table_name WHERE column_name REGEXP '(abc|def)'";
    assertEquals(expectedSql, generateSql(regex));
}

4. 閱讀數(shù)據(jù)庫文檔

每種數(shù)據(jù)庫對正則表達(dá)式的支持程度不同，建議閱讀目標(biāo)數(shù)據(jù)庫的官方文檔，了解正則表達(dá)式支持的功能和限制。

五、總結(jié)

正則表達(dá)式是 SQL 中處理復(fù)雜查詢的強(qiáng)大工具，但同時也是常見的錯誤來源。通過本文的講解，我們學(xué)習(xí)了 parentheses not balanced 錯誤的成因、排查方法以及解決方案。歸納起來，應(yīng)注意以下幾點(diǎn)：

1. 始終檢查正則表達(dá)式語法，確保括號匹配。
2. 正確轉(zhuǎn)義特殊字符。
3. 簡化復(fù)雜表達(dá)式，避免超過數(shù)據(jù)庫支持能力。
4. 打印和驗(yàn)證動態(tài)生成的 SQL 語句，確保無語法錯誤。

以上就是SQL正則表達(dá)式錯誤 “parentheses not balanced“ 問題的排查和解決方案的詳細(xì)內(nèi)容，更多關(guān)于SQL正則表達(dá)式parentheses not balanced的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論