.NET 6必须用Oracle.ManagedDataAccess.Core,因其专为.NET Core及后续版本设计,解决非Core版在.NET 6+上的System.IO.FileNotFoundException兼容性问题,且支持跨平台、纯NuGet引用、Easy Connect Plus连接字符串、显式连接池配置及NLS_LANG字符集控制。

为什么.NET 6必须用 Oracle.ManagedDataAccess.Core 而不是 Oracle.ManagedDataAccess
因为 Oracle.ManagedDataAccess(非-Core 版)只支持 .NET Framework 和部分 .NET Core 3.1,它在 .NET 6+ 上会报 System.IO.FileNotFoundException: Could not load file or assembly 'System.Data.Common, Version=4.2.1.0' 这类兼容性错误。真正适配 .NET 6/7/8 的是 Oracle.ManagedDataAccess.Core —— 它是 Oracle 官方为跨平台 .NET Core 及后续版本单独维护的托管驱动,不依赖本地 DLL,也不走 GAC,纯 NuGet 引用即可运行。
NuGet 包安装与命名空间变更要同步改
执行以下命令安装正确版本:
dotnet add package Oracle.ManagedDataAccess.Core --version 3.21.130
注意三点:
-
Oracle.ManagedDataAccess.Core的命名空间是Oracle.ManagedDataAccess.Client,和旧版Oracle.DataAccess(Oracle.DataAccess.Client)完全不同,代码里所有using和类型引用都得换 - 不要同时引用
Oracle.ManagedDataAccess和Oracle.ManagedDataAccess.Core,会引发类型冲突或运行时加载失败 - 若项目中用了 EF Core,需额外安装
Oracle.EntityFrameworkCore(对应版本需匹配驱动,例如 7.x 驱动配 7.x EF Provider)
连接字符串别再写 Data Source=orcl
传统写法依赖 tnsnames.ora,而 Oracle.ManagedDataAccess.Core 默认不读这个文件,直接写就会报 ORA-12154: TNS could not resolve the connect identifier。必须用 Easy Connect Plus 格式,例如:
user id=myuser;password=mypass;data source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=mydb.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))
更简洁的写法(推荐):
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算,采用设计 token 模式使颜色天生可访问,设定排版和焦点状态规则,并提供语义检查清单。适用于构建或审查 UI。
user id=myuser;password=mypass;data source=mydb.example.com:1521/ORCLPDB1
关键点:
- 不能省略端口(即使默认 1521)
- 使用
SERVICE_NAME而非SID(尤其在 12c+ 多租户环境下) - 如果数据库启用了 TLS,需追加
SSL=true;TrustStore=/path/to/truststore.jks;等参数
连接池默认开启但容易泄漏,得主动管
Oracle.ManagedDataAccess.Core 默认启用连接池(Pooling=true),这没问题;但开发者常忽略两点:
- 没调用
con.Close()或con.Dispose()—— 即使 using 块结束,若内部异常提前跳出,可能跳过释放逻辑 - 连接字符串里没设
Connection Timeout=30和Max Pool Size=100,高并发下池子撑爆,新请求无限等待 - 日志中出现
ORA-12519: no appropriate service handler found,往往是池满且无空闲连接,不是数据库负载问题
建议在连接字符串末尾显式加固:
user id=myuser;password=mypass;data source=mydb.example.com:1521/ORCLPDB1;Connection Timeout=30;Min Pool Size=10;Max Pool Size=100;Incr Pool Size=5;
另外,生产环境务必开启连接池日志:设置环境变量 OracleConfiguration.TraceFileLocation = "/tmp/oracle-trace",便于排查泄漏源头。
最易被忽略的是字符集处理——Oracle.ManagedDataAccess.Core 默认按数据库 NLS_LANG 解析字符串,但 .NET 6 运行在 Linux 容器里时,若未显式指定 NLS_LANG=AMERICAN_AMERICA.AL32UTF8,中文字段可能变成问号或乱码,且这个行为不会报错,只静默损坏数据。


















