全文检索慢的主因是索引未同步、中文分词器配置错误或.NET驱动首次DML触发元数据查询；CONTAINS首查慢源于ODP.NET Core自动查系统表，需加Metadata Performance=Enabled关闭；中文检索须用chinese_vgram_lexer并重建索引；索引需定期sync_index和optimize_index维护。
直接结论：全文检索慢，90% 不是 contains 写错了，而是索引没同步、分词器不匹配中文、或 .net 驱动在首次 dml 时偷偷查系统表拖垮首请求。
为什么 CONTAINS 查询第一次特别慢，后续又快了？
这是 ODP.NET Core（Oracle.ManagedDataAccess.Core）的元数据发现机制导致的典型现象：只要应用首次对某张表执行 INSERT/UPDATE，驱动就会自动发起一堆 all_constraints、all_cons_columns 查询——哪怕你只用 CONTAINS 做只读检索，只要连接池里混进了带 DML 的连接，就可能触发。
- 该行为与是否用 EF Core / Dapper 无关，纯驱动层逻辑
- 只在首次访问某张表时发生，缓存后消失 → 测试环境常测不出
- 全文检索场景下，如果业务还伴随日志写入、状态更新等操作，极易中招
- 必须显式关闭：连接字符串加
Metadata Performance=Enabled（注意拼写，不是Performance Metadata）
中文全文检索返回空或漏词？检查 lexer 是否生效
Oracle 默认的 BASIC_LEXER 对中文基本无效，它按字节切分，无法识别“人工智能”是一个词。必须显式指定中文分词器，并确保创建索引时参数名拼写完全正确：
- 创建偏好时命令是：
exec ctx_ddl.create_preference('CHN_LEXER', 'chinese_vgram_lexer')（注意是chinese_vgram_lexer，不是chinese_lexer或chinese_lexcer） - 建索引时必须引用该偏好：
CREATE INDEX idx_docs_ft ON docs(content) INDEXTYPE IS CTXSYS.CONTEXT PARAMETERS('LEXER CHN_LEXER') - 验证是否生效：
SELECT preference_name, object_name FROM ctx_user_preferences看是否存在CHN_LEXER - 若已建错索引，不能 ALTER，只能
DROP INDEX ...后重建
CONTAINS 查询结果不准或性能仍差？同步和优化不能省
Oracle Text 索引不会随 DML 自动更新，CONTAINS 查的是索引快照，不是实时数据。常见误判是“我刚 INSERT 了，怎么查不到？”——其实不是语法问题，是索引没同步。
- 开发/测试阶段可手动触发：
exec ctx_ddl.sync_index('idx_docs_ft')（秒级生效） - 生产环境必须定时任务：
dbms_job.submit或dbms_scheduler.create_job，建议每 15–30 分钟一次 - 全量优化（
ctx_ddl.optimize_index(..., 'FULL')）建议每天凌晨执行一次，避免索引碎片膨胀 - 不要在查询 SQL 里用函数包裹字段，例如
CONTAINS(UPPER(content), 'AI')>0会强制走全表扫描，索引失效
多字段联合检索时 CONTAINS 性能骤降？别堆 OR 条件
写成 CONTAINS(title, 'xxx')>0 OR CONTAINS(content, 'xxx')>0 OR CONTAINS(author, 'xxx')>0 看似直观，但 Oracle 会为每个 CONTAINS 单独走一遍索引查找，再合并结果，开销翻倍。
- 正确做法是建一个跨字段的“虚拟列”索引：
CREATE INDEX idx_docs_multi ON docs(title || ' ' || content || ' ' || author) INDEXTYPE IS CTXSYS.CONTEXT - 或者用
CTXCAT索引类型（适合短文本+结构化字段组合），但需提前定义catsearch索引段 - 若字段类型含
CLOB，确认表空间配额充足，否则sync_index会静默失败
最常被忽略的一点：全文索引的维护不是“建完就一劳永逸”，而是和表 DML 频率强绑定的。没有 sync_index 的调度，CONTAINS 查的永远是过期快照；没有 Metadata Performance=Enabled，.NET 应用的首请求延迟就永远不可控。
