ODP.NET语句缓存需显式启用：连接字符串中设Statement Cache Size=n（n>0）或Open前设置OracleConnection.StatementCacheSize属性，且须配合Pooling=true；SQL文本必须完全一致并使用参数化，否则不命中。
ODP.NET 的语句缓存（Statement Cache）必须显式启用且需在连接字符串或连接对象上配置，仅靠 Oracle 客户端安装或环境变量无法自动生效。
如何在连接字符串中启用 Statement Cache
ODP.NET 通过 Statement Cache Size 连接字符串参数控制缓存开关和容量。值为 0 表示禁用（默认），大于 0 才启用：
-
Statement Cache Size=10：启用缓存，最多缓存 10 条已准备的OracleCommand对象 - 该设置作用于单个
OracleConnection实例，不同连接间缓存不共享 - 必须与
Pooling=true（连接池启用）配合使用才具实际价值；否则每次新建连接都会重建缓存 - 常见错误：漏写空格或拼错大小写（如
statementcachesize或StatementCacheSize驼峰不匹配）——ODP.NET 会静默忽略无效参数
示例有效连接字符串：Data Source=ORCL;User Id=scott;Password=tiger;Statement Cache Size=20;Connection Timeout=30;Pooling=true;
如何在运行时通过 OracleConnection 属性启用
若连接字符串不可控（如依赖配置中心），可在打开连接后动态设置 OracleConnection.StatementCacheSize 属性：
- 必须在调用
Open()之前设置，否则抛出InvalidOperationException：“The connection is already open.” - 设置后对当前连接及其后续所有
OracleCommand生效，但不会影响已存在的命令对象 - 该属性值优先级高于连接字符串中的
Statement Cache Size（后者会被覆盖）
示例代码片段：
var conn = new OracleConnection(connStr); conn.StatementCacheSize = 15; // 必须在 Open 前 conn.Open();
哪些 SQL 不会被缓存？缓存失效的常见原因
ODP.NET 语句缓存只缓存“结构相同、参数占位符一致”的 OracleCommand。以下情况会导致不命中或缓存被绕过：
- SQL 文本存在任意空格、换行、大小写差异（如
"SELECT * FROM emp"和"select * from emp"被视为不同语句） - 使用了非绑定参数的字符串拼接（如
"WHERE id = " + id），导致每次 SQL 字符串都不同 - 执行了
OracleCommand.Prepare()后又修改了CommandText或Parameters集合 - 连接被关闭（
Close()）或归还连接池时，该连接关联的缓存条目会被清空 - 缓存大小超限时，采用 LRU 策略淘汰，老语句被踢出
验证缓存是否真正生效
光看连接字符串设了 Statement Cache Size 不代表缓存正在工作。最直接的方式是观察 Oracle 侧的硬解析次数变化：
- 在 SQL*Plus 中执行
SELECT sql_text, parse_calls, executions FROM v$sql WHERE sql_text LIKE '%your_table%'; - 开启缓存后重复执行同一参数化查询，
parse_calls应保持为 1，executions持续增长 - 若
parse_calls随执行次数增加，说明缓存未命中，需检查 SQL 文本一致性或参数绑定方式 - 注意：ODP.NET 自身无内置日志开关输出缓存命中/未命中详情，依赖数据库视图或 Oracle 性能分析工具定位
缓存逻辑发生在 .NET 客户端内存中，不涉及 Oracle 服务端配置，但它的效果完全取决于你写的 SQL 是否可复用——哪怕只多一个空格，就等于扔掉了整个缓存机制。
