Lucene 多條件查詢：MUST (AND) 與 SHOULD (OR) 行為差異與除錯

問題現象

使用 MultiFieldQueryParser 組合兩個欄位 code 與 name，設定 Occur.MUST（AND）查無結果；改為 Occur.SHOULD（OR）卻能查到。

可能原因

1. 分詞器導致詞項不匹配：AnsjAnalysis 可能將 "特惠" 切分為 "特"、"惠"，查詢字串 "特惠" 未經相同分詞處理。
2. 大小寫敏感：索引建立時轉小寫，查詢字串含大寫（如 "CA0000001"）。
3. 欄位類型不符：code 欄位若為 KeywordAnalyzer 不分詞，查詢需完全匹配。

解決步驟

1. 統一分詞器

Analyzer analyzer = new AnsjAnalysis(); // 索引與查詢使用相同分詞器
QueryParser parser = new MultiFieldQueryParser(Version.LUCENE_36, new String[]{"code", "name"}, analyzer);
parser.setDefaultOperator(QueryParser.Operator.AND); // 預設 AND
Query query = parser.parse("CA0000001 特惠"); // 讓解析器自行處理多欄位

2. 檢查索引內容

// 使用 Luke 工具或程式碼列出索引詞項
IndexReader reader = DirectoryReader.open(directory);
Terms terms = MultiFields.getTerms(reader, "name");
TermsEnum te = terms.iterator();
BytesRef term;
while ((term = te.next()) != null) {
    System.out.println(term.utf8ToString());
}

3. 使用 BooleanQuery 精確控制

BooleanQuery.Builder builder = new BooleanQuery.Builder();
builder.add(new TermQuery(new Term("code", "CA0000001")), Occur.MUST);
builder.add(new TermQuery(new Term("name", "特惠")), Occur.MUST);
Query query = builder.build();

最佳實務

• 索引與查詢**必須使用相同 Analyzer**。
• 避免直接用 MultiFieldQueryParser.parse 陣列版，改用 BooleanQuery 組合更清晰。
• 對於不分詞的 ID 欄位，使用 KeywordAnalyzer 或 StringField。