如何在.NET 8中连接Oracle 19c

Oracle.ManagedDataAccess是.NET 8连接Oracle 19c唯一推荐驱动，纯托管、跨平台、无需本地客户端；必须安装最新稳定版（如23.5.0），禁用System.Data.OracleClient和Oracle.DataAccess；连接字符串需显式设置Unicode=True、Pooling=true及Service_Name，并启用BindByName=true以确保参数绑定正确。

Oracle.ManagedDataAccess 是唯一推荐的驱动

在 .NET 8 中连接 Oracle 19c，Oracle.ManagedDataAccess 是最新唯一维护、跨平台（Windows/Linux/macOS）、且支持 .NET 8 的驱动。别再用已废弃的 System.Data.OracleClient（早被移除），也别试图硬套旧版 Oracle.DataAccess（不兼容 .NET Core+，会报 DllNotFoundException 或 PlatformNotSupportedException）。

安装方式很简单：

1. 通过 NuGet 安装：dotnet add package Oracle.ManagedDataAccess --version 23.5.0（推荐用最新稳定版，如 23.5.0 或更高；版本号对应 Oracle Client 23c，但完全兼容 Oracle 19c）
2. 确保项目 SDK 是 Microsoft.NET.Sdk.Web 或 Microsoft.NET.Sdk，而非旧式 csproj
3. 不需要本地安装 Oracle Instant Client —— Oracle.ManagedDataAccess 是纯托管实现，开箱即用

连接字符串必须显式指定 Unicode 和 Pooling

Oracle 19c 默认字符集通常是 AL32UTF8，而 .NET 8 的 string 是 UTF-16。若连接字符串没配对，容易出现乱码或 ORA-12704: character set mismatch。同时，默认连接池开启，但某些场景（如频繁短连接）可能引发 ORA-01012: not logged on 或连接泄漏。

推荐连接字符串写法：

data source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=my-oracle-server)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)));user id=myuser;password=mypass;Unicode=True;Connection Timeout=30;Pooling=true;Min Pool Size=1;Max Pool Size=10;

1. Unicode=True 强制启用 Unicode 模式（等价于 charset=UTF8），避免 NCHAR/NVARCHAR2 字段读写出错
2. Pooling=true 开启连接池，但务必配合 Min Pool Size 和 Max Pool Size 控制资源占用
3. 不要用 TNS alias（如 data source=MYDB），除非你部署时同步配置了 tnsnames.ora —— 这在容器或 Linux 部署中极易失败

使用 OracleCommand 时必须显式设置 BindByName = true

Oracle 参数绑定默认按位置（position-based），但 C# 的命名参数习惯会让开发者误写成 cmd.Parameters.Add(":name", "Alice") 却不生效，结果查不到数据或报 ORA-01008: not all variables bound。

正确做法是每次创建 OracleCommand 后立即设：

var cmd = conn.CreateCommand();cmd.BindByName = true; // 关键！否则 :name 不会被识别cmd.CommandText = "SELECT * FROM users WHERE name = :name AND status = :status";cmd.Parameters.Add(":name", OracleDbType.Varchar2).Value = "Alice";cmd.Parameters.Add(":status", OracleDbType.Int32).Value = 1;

1. BindByName = true 必须在设置 CommandText 之后、添加参数之前或之后都行，但不能漏
2. 避免用 AddWithValue —— 它会推断类型，对 NUMBER/DATE 易出错；始终显式指定 OracleDbType
3. 如果执行 PL/SQL 块（如 BEGIN ... END;），注意末尾不能有分号（;），否则触发 ORA-00900: invalid SQL statement

异步方法需注意 OracleTransaction 的 Dispose 行为

.NET 8 的 await conn.OpenAsync() 和 await cmd.ExecuteNonQueryAsync() 没问题，但若手动控制事务，OracleTransaction 的 Dispose() 在未提交/回滚时会静默调用 Rollback() —— 看似安全，实则掩盖逻辑错误。

典型风险代码：

using var tx = await conn.BeginTransactionAsync();await cmd.ExecuteNonQueryAsync(); // 忘了 commit// tx.Dispose() 自动 rollback，但无日志、无异常，业务状态丢失

1. 永远用 try/catch/finally 或 using + 显式 Commit()/Rollback()
2. 不要依赖 Dispose() 回滚：它不抛异常，也不记录，调试时极难发现
3. 若用 EF Core 7+，它内部已封装事务管理；但原生 ADO.NET 场景下，这一步必须人工把关

Oracle 19c 的连接行为在 .NET 8 下整体稳定，但 Unicode 处理、参数绑定和事务释放这三个点，稍不留神就会让程序在测试环境跑通、上线后偶发失败。尤其注意 BindByName 和 Unicode=True —— 它们不是可选项，而是必须项。