如何为.NET应用正确配置Oracle的连接字符串参数

必须写全User ID、Password和完整Data Source（含HOST、PORT、SERVICE_NAME），不可依赖tnsnames.ora别名；EF Core需纯键值对格式，禁用Provider前缀，且UseOracle()须显式调用。

直接用 oracle.manageddataaccess.client，别碰 system.data.oracleclient —— 它早在 .net framework 4.0 后就废弃了，且不支持 .net core / .net 5+。

连接字符串里哪些参数必须写全？

如果你不依赖本地 tnsnames.ora 文件（推荐不依赖），就必须把网络地址、端口、服务名全部展开写进 Data Source。只写一个 orcl 或 XE 这类别名，会报 ORA-12154: TNS:could not resolve the connect identifier。

• Data Source 必须是完整描述： (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)))
• User ID 和 Password 区分大小写，且 Oracle 默认把用户名转成大写（scott 实际按 SCOTT 认）
• 不要加 persist security info=true，生产环境必须设为 false（默认就是 false，显式写反而容易漏）
• 如果数据库启用了 SSL/TLS，需额外加 SSL Server Certificate=Distinguished Name 等参数，但绝大多数内网环境不需要

为什么连得上 PL/SQL 却连不上 .NET 应用？

常见原因是驱动不匹配或路径冲突。PL/SQL 用的是本地 Oracle Client（比如 12c 或 19c），而 .NET 应用默认走托管驱动 Oracle.ManagedDataAccess —— 它完全不依赖本地客户端安装，但也因此无法读取你机器上的 tnsnames.ora 或 sqlnet.ora。

• 确认项目引用的是 Oracle.ManagedDataAccess NuGet 包（不是 Oracle.DataAccess）
• 删掉所有 ORACLE_HOME 环境变量 —— 托管驱动会主动忽略它，但残留变量可能干扰调试
• 如果用了 OracleConnection 却抛出 System.DllNotFoundException，说明误装了非托管驱动（Oracle.DataAccess），它需要本地 Oracle Client 支持
• 64 位应用加载 32 位 Oracle Client（或反之）也会失败，但托管驱动没这个问题

EF Core 连 Oracle 时 ConnectionString 的特殊坑

EF Core 不认 providerName，也不接受带 Provider= 前缀的老式 OLE DB 格式。必须用纯键值对格式，且 Data Source 里不能有换行或多余空格 —— 某些版本 EF Core 会把含空格的括号结构解析失败。

• 正确写法：User Id=HR;Password=hr123;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XE)))
• 错误写法：Provider=OraOLEDB.Oracle.1;...（EF Core 直接忽略 provider 部分，连接失败）
• EF Core 7+ 要求在 DbContext.OnConfiguring 中显式调用 UseOracle(...)，不能只靠连接字符串
• 连接字符串长度超过 200 字符一般没问题，但旧版 System.Data.OracleClient 有 128 字符限制 —— 别再用它了

最易被忽略的一点：Oracle 默认把所有未加双引号的标识符（表名、列名）转成大写。你在 EF Core 里定义的 [Table("users")] 如果数据库里实际是 USERS 就能通；如果是 Users（带小写），就得写成 [Table(""Users"")] —— 双引号和转义缺一不可。