C#使用Oracle.ManagedDataAccess.Client无法连接Docker部署的Oracle 19c数据库

本地运行doctorkirk/oracle19c的Docker容器，Oracle SQL Developer能正常连接，但C#应用通过Oracle.ManagedDataAccess.Client连接时一直报超时错误：

Oracle.ManagedDataAccess.Client.OracleException (0x80004005):

Connection request timed out

试过各种连接字符串写法、调整连接池参数都无效，想要获取更详细错误提示排查问题，可按以下操作尝试：

1. 开启Oracle Managed驱动的详细日志 #

在项目的App.config或Web.config中添加配置，让驱动输出连接过程的完整日志：

<configuration>
  <oracle.manageddataaccess.client>
    <version number="*">
      <settings>
        <setting name="TraceLevel" value="7" /> <!-- 最高级别日志 -->
        <setting name="TraceOption" value="1" />
        <setting name="TraceFileLocation" value="C:\OracleLogs" /> <!-- 确保目录存在且应用有写入权限 -->
      </settings>
    </version>
  </oracle.manageddataaccess.client>
</configuration>

运行程序后去指定目录查看日志，里面会记录连接过程的每一步细节，有助于定位问题节点。

2. 捕获完整的异常信息 #

不要只返回ex.Message，把异常的堆栈跟踪和内部异常全部输出，内部异常往往包含更底层的错误原因：

using Oracle.ManagedDataAccess.Client;
// ...
string connStr = "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=mydb)));User ID=user1;Password=pass1;";

using (OracleConnection conn = new OracleConnection(connStr))
{
    try
    {
        conn.Open();
        Console.WriteLine("success");
    }
    catch (Exception ex)
    {
        var errorInfo = new System.Text.StringBuilder();
        errorInfo.AppendLine($"错误消息: {ex.Message}");
        errorInfo.AppendLine($"堆栈跟踪: {ex.StackTrace}");
        if (ex.InnerException != null)
        {
            errorInfo.AppendLine($"内部错误: {ex.InnerException.Message}");
            errorInfo.AppendLine($"内部堆栈: {ex.InnerException.StackTrace}");
        }
        return errorInfo.ToString();
    }
}

3. 验证Docker端口映射是否正确 #

虽然SQL Dev能连接，但再确认容器的1521端口是否正确映射到本地：
运行docker ps，查看容器的端口列是否有0.0.0.0:1521->1521/tcp或者127.0.0.1:1521->1521/tcp，若映射的是其他端口，需同步修改连接字符串中的PORT值。

4. 用容器IP替代localhost尝试 #

部分环境下localhost的解析可能存在问题，先获取容器的IP地址：

docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <你的容器ID或名称>

将连接字符串里的HOST=localhost替换为这个IP，重新运行程序，观察是否出现不同的错误提示。

5. 确认Oracle服务名是否正确 #

通过SQL Developer连接容器后，执行以下SQL查询确认服务名：

SELECT name, value FROM v$parameter WHERE name = 'service_names';

若查询结果中的value不是mydb，修改连接字符串里的SERVICE_NAME为正确值。

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