ORA-12154 根源是 .NET 程序未正确加载或解析 tnsnames.ora：Managed 驱动不读该文件，Unmanaged 驱动才依赖它；需确认 oci.dll 来源、TNS_ADMIN 是否生效、文件编码/格式/路径是否合规，并用 tnsping 验证。
ora-12154 不是数据库连不上，而是 .net 程序根本没找到或没读对 tnsnames.ora 文件。 它发生在 oracle 客户端解析连接别名阶段，和网络通不通、监听器起没起、密码对不对都无关——连那些环节都还没走到。
确认 .NET 程序到底用的是哪个 Oracle 客户端
.NET 程序（比如用 Oracle.ManagedDataAccess 或 Oracle.DataAccess）是否加载了你认为的那个客户端，是第一个必须掐住的点。Managed 驱动（ODP.NET Managed Driver）完全不读 tnsnames.ora，它只认连接字符串里的完整地址；而旧版 Unmanaged 驱动（Oracle.DataAccess）才依赖本地 Oracle Client 和 tnsnames.ora。
- 查项目引用：如果 NuGet 引的是
Oracle.ManagedDataAccess，那改tnsnames.ora无效，必须用host:port/service_name格式写死连接字符串 - 如果用的是
Oracle.DataAccess，得确认程序运行时加载的oci.dll来自哪——它可能从系统 PATH 里随便抓一个 Oracle Home，而不是你配置的那个 - 在 Windows 上，用 Process Explorer 查看你的 .NET 进程加载了哪个路径下的
oci.dll，比猜环境变量靠谱得多
tnsnames.ora 文件本身是否被真正识别
即使路径对了，文件里一个不可见字符就能让整个解析失败，报错还是 ORA-12154，且不提示具体哪行错。
- 用记事本打开再保存，大概率引入 BOM 或 ANSI 编码 —— 改用 VS Code 或 Notepad++，显式另存为 UTF-8 无 BOM
- 条目开头不能有空格或制表符：
MYDB =是错的，MYDB=才对；等号前后、括号内外都不能有多余空格 - 注释必须用
!开头（不是#），且叹号后要带空格：! this is ok，!this is not - 最简验证法：临时把
$ORACLE_HOME/network/admin/tnsnames.ora改名，只留你指定的TNS_ADMIN下那个，再跑程序 —— 如果还报 ORA-12154，说明TNS_ADMIN根本没生效
TNS_ADMIN 环境变量在 .NET 进程里是否真被继承
你在 CMD 里 set TNS_ADMIN=xxx 成功，不代表你的 .NET 程序（尤其是从 IDE 启动、双击 exe、IIS 托管的）能拿到它。
- Windows 下，.NET Core/.NET 5+ 默认不继承父进程环境变量，需在启动前显式设置：
Environment.SetEnvironmentVariable("TNS_ADMIN", @"C:\my\tns") - IIS 应用池默认运行在孤立会话中，系统环境变量对其不可见；必须在应用池高级设置里勾选“加载用户配置文件”，或直接在 web.config 的
- Visual Studio 调试时，环境变量来自“项目属性 → 调试 → 环境变量”设置，不是系统级变量；改完要重启 VS 才生效
- 用
tnsping MYDB测试：它和 .NET 程序走同一套解析逻辑，成功返回OK才算真正通了
容易被忽略的权限与路径拼写细节
看似低级，但高频踩坑：
-
TNS_ADMIN路径末尾不能带反斜杠：C:\oracle\net\admin\是错的，C:\oracle\net\admin才对 - 路径含空格或中文？Windows 下某些 Oracle 版本会静默失败，建议全用英文路径
- Linux/macOS 下注意大小写：
TNS_ADMIN必须全大写，tnsnames.ora文件名必须小写，目录名network/admin也区分大小写 - 如果你机器上装了多个 Oracle 客户端（比如 Instant Client + DB Client + PL/SQL 自带 OCI），它们的搜索顺序可能绕过
TNS_ADMIN—— 尤其是 PL/SQL Developer 会优先读注册表，而非环境变量
真正卡住人的，往往不是 listener 没启、IP 写错这种显性问题，而是 tnsnames.ora 被某个隐藏的编码、空格、加载顺序或权限挡在了解析门外。动手前，先确认程序到底加载了哪个 oci、tnsping 是否通过、环境变量是否进到了进程里 —— 这三步比反复重配 listener 有用得多。
