ORA-12154 根源是 .NET Core 应用未找到或未正确读取 tnsnames.ora：Managed 驱动仅认 TNS_ADMIN 指定路径下的 UTF-8 无 BOM 文件，且别名须顶格、大小写严格匹配；tnsping 成功但应用报错说明环境变量未被进程继承。
ora-12154 不是网络不通，也不是密码错，而是 .net core 应用根本没找到或没读对你的连接别名 —— 它连“去哪查”都不知道。
tnsnames.ora 文件是否被 .NET Core 实际加载
.NET Core 的 Oracle 客户端（如 Oracle.ManagedDataAccess）默认不依赖系统级 tnsnames.ora，除非你显式配置。它按 sqlnet.ora 中 names.directory_path 指定的顺序查找解析源，而该文件若未提供，会退回到硬编码路径或忽略 tnsnames.ora。
- 检查你的应用是否设置了
TNS_ADMIN环境变量：它必须指向含tnsnames.ora的目录（如C:\oracle\instantclient_21_12\NETWORK\ADMIN），且该目录下文件权限为可读 - 在代码中验证路径是否生效：
Environment.GetEnvironmentVariable("TNS_ADMIN")必须返回非空值；否则tnsnames.ora被完全跳过 - 别名行首不能有空格或制表符 —— Windows 记事本看不见，但
tnsping YourAlias会直接报TNS-03505；用 VS Code 打开并开启“显示不可见字符”确认 - 保存
tnsnames.ora时选 UTF-8 无 BOM，BOM 字节会导致整个文件解析失败
连接字符串里用别名还是直连地址
在 .NET Core 中，用别名（如 "Data Source=ORCL;User Id=scott;Password=tiger;"）本质是让 ODP.NET 去查本地 tnsnames.ora；而直连格式（如 "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.10)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)))"）完全绕过名称解析链路。
- 开发阶段优先用直连字符串：排除
tnsnames.ora路径、语法、大小写等干扰 - 若必须用别名，确保
sqlnet.ora存在且含names.directory_path = (tnsnames)；没有该行或值不含tnsnames，别名即失效 - 注意大小写敏感：
tnsnames.ora里写的是ORCL = ...，连接串里就不能写orcl - 别名后不能跟注释，例如
ORCL = ... # dev是非法的；注释必须独占一行且以#开头
Oracle.ManagedDataAccess 和 Oracle.DataAccess 的行为差异
这两个驱动对环境变量和配置文件的依赖程度不同：Oracle.ManagedDataAccess（推荐用于 .NET Core）纯托管，不读注册表，只认 TNS_ADMIN 和当前目录下的 sqlnet.ora；而旧版 Oracle.DataAccess（需 Oracle Client）会查注册表和系统 PATH。
- 确认项目引用的是
Oracle.ManagedDataAccess（NuGet 包），不是已废弃的Oracle.DataAccess -
Oracle.ManagedDataAccess不受系统 PATH 中 Oracle Client 位置影响，只看你是否设了TNS_ADMIN - 若混用多个 Oracle 客户端版本（比如机器上装了 12c 和 19c Instant Client），
TNS_ADMIN必须精确指向你要用的那个版本的NETWORK\ADMIN - 调试时加一句
Console.WriteLine(OracleInternal.Common.ConfigBase.GetConfigValue("TNS_ADMIN"));可确认驱动实际读取的路径
tnsping 成功但 .NET Core 仍报 ORA-12154 怎么办
这说明客户端环境和你的应用运行环境不一致 —— tnsping 用的是命令行当前用户的环境变量，而 .NET Core 应用可能跑在 IIS、Windows Service 或 Docker 容器里，它们的环境变量是隔离的。
- 在应用启动时打印
Environment.GetEnvironmentVariable("TNS_ADMIN")和Environment.GetEnvironmentVariable("ORACLE_HOME")，确认值与你预期一致 - IIS 应用池默认以
ApplicationPoolIdentity运行，该账户看不到用户级环境变量；需在应用池高级设置中启用“加载用户配置文件”，或改用本地服务账户并手动设环境变量 - Docker 中必须通过
ENV TNS_ADMIN /opt/oracle/instantclient_21_12/network/admin显式注入，不能依赖宿主机设置 - 最稳的兜底方案：不用别名，把完整连接描述符（
(DESCRIPTION=...)）直接写进连接字符串，彻底避开名称解析环节
真正卡住人的地方往往不是监听器或数据库本身，而是 .NET Core 进程根本没看到你精心配好的 tnsnames.ora —— 它甚至不知道该去哪找这个文件。环境变量是否生效、驱动是否认这个变量、运行上下文是否隔离，这三层最容易漏检。
