推荐使用 Oracle.ManagedDataAccess(非.Core版)连接Oracle数据库,它纯.NET实现、免客户端安装;注意区分.NET Framework与.NET Core/5+的包版本,连接字符串需正确配置,优先用using确保资源释放。

用 Oracle.ManagedDataAccess 连接 Oracle 数据库
推荐直接使用 Oracle.ManagedDataAccess(ODP.NET Managed Driver),它不依赖 Oracle 客户端安装,纯 .NET 实现,部署简单。NuGet 包名就是 Oracle.ManagedDataAccess,不是旧版的 System.Data.OracleClient(已弃用)或需要本地 Oracle Client 的 Oracle.DataAccess。
常见错误:项目里装了 Oracle.ManagedDataAccess.Core 却在 .NET Framework 项目中引用 —— 这会导致运行时报 Could not load file or assembly 'Oracle.ManagedDataAccess' 。注意区分:.Core 仅用于 .NET Core / .NET 5+;传统 .NET Framework 项目必须用非 .Core 版本。
- 在 Visual Studio 中右键项目 → “管理 NuGet 包” → 搜索并安装
Oracle.ManagedDataAccess(无 .Core 后缀) - 连接字符串格式示例:
"User Id=myuser;Password=mypass;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)))" - 若使用 TNS 别名(如
ORCL),确保tnsnames.ora在应用可访问路径下,或改用 EZConnect 格式:"User Id=myuser;Password=mypass;Data Source=myhost:1521/orcl"
写一个最小可用的 OracleConnection 打开测试
别一上来就写 ORM 或封装类,先验证驱动和连接是否通。重点看 Open() 是否抛异常,以及异常类型 —— 大部分连不上都是连接字符串或网络问题,不是代码逻辑问题。
using Oracle.ManagedDataAccess.Client;string connStr = "User Id=scott;Password=tiger;Data Source=localhost:1521/orcl"; using (var conn = new OracleConnection(connStr)) { try { conn.Open(); Console.WriteLine("✅ 连接成功,版本:" + conn.ServerVersion); } catch (OracleException ex) { Console.WriteLine("❌ Oracle 错误:" + ex.Number + " - " + ex.Message); } catch (Exception ex) { Console.WriteLine("❌ 其他异常:" + ex.Message); } }
注意:OracleException 的 Number 字段很关键,比如 ORA-12154 是解析不到服务名,ORA-12541 是监听器没响应,ORA-01017 是用户名密码错 —— 这些数字比错误消息更可靠,适合日志分类。
执行查询时要注意参数命名和数据类型
Oracle 的参数前缀是冒号 :,不是 @ 或 ?,且**大小写敏感**。同时,OracleParameter 的 OracleDbType 显式指定类型比靠推断更稳,尤其对 CLOB、DATE、NUMBER 等易出错类型。
Difeye是一款超轻量级PHP框架,主要特点有: Difeye是一款超轻量级PHP框架,主要特点有: ◆数据库连接做自动主从读写分离配置,适合单机和分布式站点部署; ◆支持Smarty模板机制,可灵活配置第三方缓存组件; ◆完全分离页面和动作,仿C#页面加载自动执行Page_Load入口函数; ◆支持mysql,mongodb等第三方数据库模块,支持读写分离,分布式部署; ◆增加后台管理开发示例
- 参数名必须带冒号:
cmd.Parameters.Add(new OracleParameter(":id", 123)),写成"id"或"@id"都会报ORA-01036 - 查询含中文或特殊字符时,确保数据库字符集(如 AL32UTF8)与客户端一致,否则
GetString()可能乱码 -
OracleCommand.CommandTimeout默认是 30 秒,长查询记得调大,否则超时后连接可能未释放
连接池默认开启,但要注意泄漏和状态残留
Oracle.ManagedDataAccess 默认启用连接池,这很好,但容易掩盖 Connection 忘记 Close() 或 Dispose() 的问题。连接池里的物理连接不会立刻关闭,而是回收复用 —— 表面看程序跑得动,实际可能耗尽池子(默认上限 100)。
典型症状:应用运行一段时间后,新请求卡住、超时,日志里反复出现 ORA-12519: no appropriate service handler found 或 Timeout expired。
- 务必用
using块包裹OracleConnection和OracleCommand - 不要手动调用
ClearAllPools()除非真有连接状态污染(如 ALTER SESSION),它会强制所有连接重连,伤性能 - 可通过连接字符串加
Pooling=true;Min Pool Size=5;Max Pool Size=50;控制池行为
最常被忽略的是连接字符串里混用了不同用户、不同服务名但共用同一个连接池键 —— ODP.NET 会把它们当同一池,导致权限或 schema 错乱。每个独立业务场景建议用唯一连接字符串,或显式关池:Pooling=false(仅调试用)。









