C#怎么连接Oracle数据库_C#如何使用ODP.NET驱动【实战】-C#.Net教程-PHP中文网

优先使用 Oracle.ManagedDataAccess，它是纯托管驱动，NuGet 一键安装，不依赖本地 Oracle Client，兼容 .NET Framework 和 .NET Core / .NET 5+；而 Oracle.DataAccess（ODP.NET Unmanaged）需安装对应位数的 Oracle 客户端，易因 DLL 版本、PATH 或架构不匹配导致 DllNotFoundException 或 BadImageFormatException。

Oracle.ManagedDataAccess 还是 Oracle.DataAccess？

用 oracle.manageddataaccess，别碰 oracle.dataaccess（即旧版 odp.net unmanaged）。后者依赖 oracle 客户端本地安装，部署时容易因 dll 版本、位数（x86/x64）、path 环境变量错乱直接报 system.dllnotfoundexception 或 badimageformatexception。而 oracle.manageddataaccess 是纯托管驱动，nuget 一键安装，不依赖 oracle client，.net core / .net 5+ 和传统 .net framework 都能跑。

实操建议：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

在项目中通过 NuGet 安装 Oracle.ManagedDataAccess（注意：不是 Oracle.ManagedDataAccess.Core，后者已归档，新项目统一用前者）
连接字符串里不用写 Data Source=... 的 TNS 别名，除非你真配了 tnsnames.ora；更推荐用 Easy Connect 格式："Data Source=localhost:1521/ORCLPDB1;User Id=myuser;Password=mypass;"
如果连的是 Oracle 12c 及以后的多租户库，Service Name（如 ORCLPDB1）比 SID（如 ORCL）更可靠

Connection.Open() 报 ORA-12154：TNS 无法解析指定的连接标识符

这错误八成不是网络问题，而是连接字符串格式或 DNS 解析失败。尤其当你误用了 SID 却没配 tnsnames.ora，或者 Service Name 拼错、大小写敏感（Oracle 服务名默认区分大小写）时，就会卡在这。

实操建议：

优先用 Easy Connect 语法，避开 tnsnames.ora 配置：格式为 host:port/service_name，例如 localhost:1521/XEPDB1
确认监听器确实在运行：lsnrctl status（Linux/macOS）或服务里检查 OracleOraDB21Home1TNSListener 是否启动
用 tnsping 测试基础连通性：tnsping localhost:1521/XEPDB1 —— 如果它都通不了，OracleConnection.Open() 必然失败
连接字符串中不要加多余空格，特别是 User Id 和 Password 前后；密码含特殊字符（如 @、/）要 URL 编码，但更稳妥的做法是改密码或用 Windows 身份验证（需数据库侧配置）

执行查询时 DateTime 字段变成 1900-01-01 或精度丢失

OracleCommand 默认把 DateTime 当作 DATE 类型处理，而 Oracle 的 DATE 只存到秒，不带毫秒和时区；如果你的字段实际是 TIMESTAMP 或 TIMESTAMP WITH TIME ZONE，就会截断或转换出错。

实操建议：

读取时显式指定类型：cmd.Parameters.Add("p_date", OracleDbType.TimeStamp).Value = DateTime.Now;
写入 TIMESTAMP WITH TIME ZONE 字段，用 OracleDbType.TimeStampTZ，并传 DateTimeOffset 实例，别用 DateTime
避免用 SELECT * FROM ... —— OracleDataReader.GetDateTime() 对 TIMESTAMP 字段会静默截断；改用 GetOracleTimeStamp() 或 GetValue() 后手动转型
如果必须用 DateTime 映射，且业务允许秒级精度，在连接字符串加 StmtCacheSize=0 并禁用语句缓存（某些版本缓存会固化类型推断）

部署到 IIS 或 Linux 容器时报“Could not load file or assembly 'Oracle.ManagedDataAccess'”

这不是缺 DLL，而是加载上下文冲突：常见于混合使用多个 Oracle 驱动版本（比如项目引用 v21.x，但 GAC 或全局 bin 里混着 v19.x），或 ASP.NET Core 项目未正确发布依赖项。

实操建议：

检查 bin 目录下是否只存在一个 Oracle.ManagedDataAccess.dll，且版本与 NuGet 引用一致；用 dotnet list package 确认无传递依赖引入旧版
ASP.NET Core 发布时确保 IncludeAllContentForCore 或 PublishTrimmed=false（.NET 6+ 默认裁剪可能误删 Oracle 驱动资源）
Linux 容器中，确认目标 runtime（如 linux-x64）与发布的 RID 匹配；Oracle.ManagedDataAccess 不分平台，但若你误装了 Oracle.ManagedDataAccess.Core（仅限 .NET Core 2.x），就会在 .NET 6+ 上静默失败
在 Global.asax 或 Program.cs 开头加一行日志：Console.WriteLine(typeof(OracleConnection).Assembly.Location);，确认加载的是你预期的那个 DLL