Oracle.ManagedDataAccess版本必须匹配.NET运行时与Oracle服务端，.NET 6+用5.0+（如5.23.1），.NET Framework 4.7.2推荐2.0.22；禁用Oracle.DataAccess和Oracle.ManagedDataAccess.Core；连接字符串需含TNS_ADMIN或用Easy Connect；启用Validate Connection和合理连接池参数；异步操作须全程await，避免.Wait()或.Result。
Oracle.ManagedDataAccess NuGet 包必须装对版本
装错版本是连接失败最常见原因，不是“装了就行”，而是得匹配你的 .net 运行时和 oracle 服务端兼容性。.net 6+ 应用必须用 oracle.manageddataaccess 5.0+（如 5.23.1），老项目用 .net framework 4.7.2 的话，oracle.manageddataaccess 2.0.22 是更稳的选择——它不依赖本地 oracle client，但 19c 服务端可能触发 ora-28775（tls 握手失败），这时得升级到 5.22.1 或更高。
安装命令别手抖：
dotnet add package Oracle.ManagedDataAccess --version 5.23.1或者用 VS GUI 时，务必点开“Include prereleases”勾选框，否则最新稳定版可能不显示。
- 别装
Oracle.DataAccess（已废弃，只支持旧版非托管驱动） - 别通过“程序包管理器控制台”运行
Install-Package Oracle.ManagedDataAccess.Core——这个包早已被官方弃用，会引发TypeLoadException - 若项目同时引用了
System.Data.OracleClient（已过时），必须彻底移除，否则类型冲突导致InvalidOperationException：“The provider is not compatible with the version of Oracle client”
连接字符串里不能漏掉 TNS_ADMIN 或直接写完整连接信息
Managed 驱动默认不读取系统 ORACLE_HOME 或 tnsnames.ora，除非你显式告诉它在哪。常见错误是照搬旧代码写 Data Source=MYDB，结果抛出 Oracle.ManagedDataAccess.Client.OracleException: ORA-12154: TNS:could not resolve the connect identifier。
两种可靠写法：
- 用 Easy Connect 语法，绕过 tnsnames：
Data Source=localhost:1521/XE;User Id=scott;Password=tiger; - 指定
TNS_ADMIN环境变量指向含tnsnames.ora的目录，再写Data Source=MYDB；代码中设环境变量要早于首次创建OracleConnection，比如在Program.cs顶部加：Environment.SetEnvironmentVariable("TNS_ADMIN", @"C:oracle etworkdmin");
注意：路径里的反斜杠在 C# 字符串中要双写或用 @，写成 "C:\oracle\network\admin" 或 @'C:oracle
etworkdmin'，否则 DirectoryNotFoundException。
连接池默认开启，但超时和验证逻辑容易被忽略
Managed 驱动默认启用连接池（Pooling=true），好处是快，坏处是失效连接可能滞留池中，下次取出时才报 ORA-03135: connection lost contact 或 ORA-01012: not logged on。
- 加
Validate Connection=true让每次从池取连接前执行SELECT 1 FROM DUAL，代价小但能提前暴露断连 -
Connection Lifetime=60（单位秒）让连接在池中最多活 1 分钟，强制轮换，防长连接僵死 -
Min Pool Size=1; Max Pool Size=10控制池大小，高并发下别留Max Pool Size=100，Oracle 服务端许可和资源可能扛不住
示例完整连接字符串：
Data Source=localhost:1521/XE;User Id=scott;Password=tiger;Pooling=true;Validate Connection=true;Connection Lifetime=60;Min Pool Size=1;Max Pool Size=10;
异步方法要用对，别混用同步阻塞调用
OracleConnection.OpenAsync() 和 OracleCommand.ExecuteNonQueryAsync() 是真异步（基于 Oracle 网络层 I/O），但很多人写成 connection.Open().Wait() 或 Task.Run(() => connection.Open()).Result，这会导致线程池饥饿，尤其 ASP.NET Core 下请求堆积、CPU 暴涨。
- 入口方法必须标记
async，调用链顶端（如 Controller Action、Top-level statement 主函数）要await - 别在
using块里对OracleConnection调用Open()后又去await ExecuteReaderAsync()——连接已同步打开，异步执行没意义，还可能因上下文切换出问题 - 如果必须同步（如某些遗留测试框架），至少用
connection.OpenAsync().GetAwaiter().GetResult()，比.Wait()少一层异常包装
正确姿势：
using var conn = new OracleConnection(connStr);<br>await conn.OpenAsync();<br>using var cmd = conn.CreateCommand();<br>cmd.CommandText = "SELECT COUNT(*) FROM employees";<br>var count = await cmd.ExecuteScalarAsync();
连接字符串解析、驱动加载、TLS 握手这些步骤本身不耗时，但一旦网络抖动或 Oracle 服务端响应慢，同步阻塞就立刻暴露——这是生产环境偶发超时最隐蔽的来源。
