必须写全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.ManagedDataAccessNuGet 包（不是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\"")] —— 双引号和转义缺一不可。
