VB.NET连接Oracle 21c遇ORA-12541:TNS监听未找到问题求助

基于.NET Framework v4.8的VB.NET应用，使用System.Data.OracleClient命名空间连接Oracle 21c数据库时，调用connection.Open()触发ORA-12541: No TNS Listener错误。

已完成的排查操作 #

• 开发机器已安装Oracle客户端
• 数据库服务器通过lsnrctl检查，监听服务正常运行
• 开发机器执行tnsping 192.168.10.127和tnsping XE均测试成功
• 通过sqlplus命令可正常连接数据库

尝试过的连接字符串 #

两种连接字符串均触发相同错误：

1. 完整DESCRIPTION格式：

Data Source=(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.10.127)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SID = xe)));Persist Security Info=True;User ID=user;Password=pwd;

2. TNS别名格式：

Data Source=XE;User ID=user;Password=pwd

tnsnames.ora中XE的定义 #

XE =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.10.127)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SID = xe)
    )
  )

1. 替换过时的System.Data.OracleClient组件 #

System.Data.OracleClient是微软官方已弃用的组件（.NET Framework 4.0后标记为过时），对Oracle 12c+版本兼容性存在问题。建议替换为Oracle官方提供的ODP.NET组件：

• ODP.NET Managed Driver：无需安装Oracle客户端，直接通过NuGet安装Oracle.ManagedDataAccess.Core（注意匹配.NET Framework版本）
• ODP.NET Unmanaged Driver：需配合Oracle客户端使用，可通过NuGet安装Oracle.DataAccess

替换后调整连接字符串，例如ODP.NET Managed Driver的写法：

Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.127)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SID=xe)));User Id=user;Password=pwd;

或使用TNS别名（需确保客户端配置生效）：

Data Source=XE;User Id=user;Password=pwd;

2. 匹配应用与Oracle客户端的位数 #

若坚持使用System.Data.OracleClient，需保证：

• 应用编译为x86时，安装32位Oracle客户端
• 应用编译为x64时，安装64位Oracle客户端
  同时检查系统PATH环境变量，确保Oracle客户端的bin目录排在其他Oracle组件路径之前，避免版本冲突。

3. 确认监听的实例注册状态 #

执行lsnrctl services命令，检查输出中是否存在xe实例的服务项，确认监听实际注册了目标SID：

lsnrctl services

4. 修正连接字符串格式细节 #

• 移除连接串中不必要的空格，例如将(DESCRIPTION =简化为(DESCRIPTION=
• 确保User ID和Password的大小写与数据库用户一致（Oracle默认启用用户名密码大小写敏感，需严格匹配）

内容的提问来源于stack exchange，提问作者philipp8230