ORA-12154在.NET Core 3.1+中根本不是网络或认证问题，而是Oracle.ManagedDataAccess.Core默认禁用TNS解析，不读取tnsnames.ora；必须改用Easy Connect格式（如Data Source=localhost:1521/XEPDB1）或显式设置OracleConfiguration.TnsAdmin。
ORA-12154 不是网络问题，也不是密码错，而是 Oracle.ManagedDataAccess.Core 根本没尝试解析 tnsnames.ora —— 它默认禁用 TNS 名称解析。
为什么 .NET Core 3.1+ 里 Data Source=ORCL 直接报错
Oracle.ManagedDataAccess.Core（以及新版 Oracle.ManagedDataAccess）在托管模式下默认不读取 tnsnames.ora，哪怕你把文件放在项目根目录、%ORACLE_HOME%\network\admin 或任意路径都没用。驱动会把 ORCL 当作主机名直接去连，自然失败。
常见误判点：
- 以为改对了
tnsnames.ora就行 —— 实际上该文件压根没被加载 - 在 .NET Framework 项目里能用的写法（如
Data Source=ORCL），迁到 .NET Core 后必然报ORA-12154 - 检查防火墙、ping 主机、telnet 端口都通，但还是报错 —— 这恰恰说明是本地解析失败，不是网络层问题
必须用 Easy Connect 或完整 DESCRIPTION 字符串
绕过 TNS 解析的最稳方案：放弃别名，显式写出地址和服务名。优先选 Easy Connect 格式，简洁且容错强。
正确写法示例：
User Id=myuser;Password=mypass;Data Source=localhost:1521/XEPDB1;
注意要点：
-
Data Source值必须是host:port/service_name，不能带空格或换行 - 服务名（
XEPDB1）不是 SID（XE），需从数据库查：SELECT value FROM v$parameter WHERE name = 'service_names'; - 若密码含
@、/、:等字符，必须 URL 编码；否则连接字符串提前截断 - Host 写
127.0.0.1比localhost更可靠（避免 IPv6 回环解析失败）
非要用 TNS 别名？得手动注册或指定 TnsAdmin
如果团队强依赖 tnsnames.ora（比如多环境共用一套配置），可启用 TNS 解析，但必须显式干预：
方式一：设置 OracleConfiguration.TnsAdmin
OracleConfiguration.TnsAdmin = @"C:\oracle\network\admin";
这行代码必须在首次创建 OracleConnection 之前执行，且路径必须精确到目录（不含文件名）。
方式二：硬编码注册别名（更可控，不依赖文件）
OracleConfiguration.OracleDataSources["ORCL_WRITE"] = "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=mydb)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb1)))";
关键细节：
- 字符串内不能有换行或首尾空格，否则静默失效
- 别名（如
ORCL_WRITE）必须和连接字符串中Data Source=的值完全一致（大小写敏感） - 此注册只对当前 AppDomain 生效，跨进程/跨域不共享
EF Core 中连接字符串写错的典型陷阱
在 UseOracle() 里直接传 Data Source=ORCL，等于把问题留给运行时 —— EF Core 不会帮你补全或提示 TNS 配置缺失。
安全做法：
- 连接字符串拼接前，先确保
OracleConfiguration.TnsAdmin已设好，或已调用OracleConfiguration.OracleDataSources.Add() - 不要在
appsettings.json里存裸别名，而应存完整 Easy Connect 地址 - Pooling=false 可临时加在连接串末尾（
;Pooling=false），排除连接池复用导致的解析干扰 - 验证手段：命令行跑
tnsping localhost:1521/XEPDB1，它通了，OracleConnection.Open()才可能成功
最易被忽略的一点：Oracle.ManagedDataAccess.Core 已停更，现在只该用 Oracle.ManagedDataAccess（无 .Core 后缀）。混用或错装包会导致类型找不到，错误信息反而掩盖了真正的 ORA-12154。
