前言

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

### 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

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

一、錯(cuò)誤的根本原因

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

1. 括號(hào)沒(méi)有正確配對(duì)

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

示例錯(cuò)誤：

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

上述表達(dá)式中，( 開(kāi)始了一個(gè)分組，但沒(méi)有匹配的 )，導(dǎo)致 SQL 執(zhí)行報(bào)錯(cuò)。

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

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

示例錯(cuò)誤：

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

正則表達(dá)式 [0-9(a-z] 中，[ 開(kāi)始了一個(gè)字符類匹配，但括號(hào)和字符范圍的嵌套未閉合，造成語(yǔ)法錯(cuò)誤。

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

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

示例錯(cuò)誤：

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

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

二、錯(cuò)誤排查步驟

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

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

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

示例：

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

修正后：

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

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

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

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

如果 SQL 語(yǔ)句是通過(guò)代碼動(dòng)態(tài)生成的，打印出最終生成的 SQL，確保表達(dá)式在代碼邏輯中未被截?cái)唷?/p>

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

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

三、解決方案

針對(duì)上述可能的錯(cuò)誤成因，提出以下解決方案：

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

確保括號(hào)或其他分隔符配對(duì)正確。

錯(cuò)誤：

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

修正：

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

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

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

示例：

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

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

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

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

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

錯(cuò)誤：

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

修正：

-- 拆分為多個(gè)簡(jiǎn)單條件
SELECT * FROM orders WHERE order_code REGEXP 'A123' OR order_code REGEXP 'B456';

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

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

四、最佳實(shí)踐

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

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

在復(fù)雜 SQL 查詢執(zhí)行前，打印并測(cè)試語(yǔ)句?？梢酝ㄟ^(guò)日志或調(diào)試工具查看最終的 SQL 輸出。

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

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

3. 編寫單元測(cè)試

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

示例：

@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ù)庫(kù)文檔

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

五、總結(jié)

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

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

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

最新評(píng)論