ORA-12154根源是.NET进程未找到或未正确读取tnsnames.ora：Oracle.ManagedDataAccess默认不读该文件，需显式设TNS_ADMIN（启动前）、确保UTF-8无BOM、别名顶格且大小写严格匹配；优先用直连字符串绕过解析。
ORA-12154 不是数据库连不上，而是 .NET 进程压根没找到或没读对 tnsnames.ora——它连“去哪查”都不知道。
确认你用的是哪个 Oracle 驱动
这直接决定你该不该折腾 tnsnames.ora：
- 如果 NuGet 引用的是
Oracle.ManagedDataAccess（.NET Core / .NET 5+ 推荐），它默认不读tnsnames.ora，只认连接字符串里的完整地址；改文件无效 - 如果引用的是
Oracle.DataAccess（旧版非托管驱动），它才依赖本地 Oracle Client 和tnsnames.ora，但需确保加载的oci.dll来自你配置的路径（可用 Process Explorer 查进程实际加载的 dll 路径）
设置并验证 TNS_ADMIN 环境变量是否生效
哪怕你用了 Oracle.ManagedDataAccess，某些版本或配合 sqlnet.ora 时仍会尝试读取，所以必须确保变量被 .NET 进程实际继承：
- 在代码启动前显式设置：
Environment.SetEnvironmentVariable("TNS_ADMIN", @"C:\oracle\instantclient_21_12\NETWORK\ADMIN"); - 不要只在 CMD 里
set TNS_ADMIN=xxx——IDE 启动、IIS 托管、Windows 服务都不会自动继承 - 运行时检查：
Environment.GetEnvironmentVariable("TNS_ADMIN")必须返回非空路径，否则整个目录被跳过 - IIS 应用池需勾选“加载用户配置文件”，否则系统环境变量不可见
tnsnames.ora 文件本身必须合规
哪怕路径对了，一个不可见字符就让解析失败，报错仍是 ORA-12154，且不提示具体哪行错：
- 用 VS Code 或 Notepad++ 打开，开启“显示不可见字符”，确认别名行首无空格、无制表符：
ORCL =是错的，ORCL=才对 - 保存为 UTF-8 无 BOM——Windows 记事本默认 ANSI 或带 BOM，会导致整文件解析失败
- 等号前后、括号内外不能有多余空格；注释必须独占一行且以
#开头（不是!）；右括号必须换行闭合 - 大小写敏感：
tnsnames.ora里写的是ORCL=，连接字符串里就不能写orcl
绕过 tnsnames.ora 的最简方案
开发阶段优先用直连格式，彻底排除名称解析链路干扰：
- 连接字符串写成：
Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.10)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)));User Id=scott;Password=tiger; -
SERVICE_NAME值区分大小写（如 12c+ 多租户下常为小写orclpdb1），别误写成 SID - 若必须用别名，确保同目录下有
sqlnet.ora，且含names.directory_path = (tnsnames)
真正容易被忽略的是：TNS_ADMIN 是否被进程继承、tnsnames.ora 是否 UTF-8 无 BOM、以及别名行是否顶格——这三个点任意一个出错，都会静默失败，只报 ORA-12154。
