Oracle.ManagedDataAccess默认使用TLS 1.2,需显式设置OracleConfiguration.TlsVersion = "TLS13"(首次创建连接前),并确保服务端监听器配置SSL_VERSION = 1.3、证书链完整,且驱动版本≥23.5。

Oracle.ManagedDataAccess 默认不启用 TLS 1.3,需显式配置驱动参数
Oracle 官方的 Oracle.ManagedDataAccess(ODP.NET)在 .NET 8 下仍默认使用 TLS 1.2,即使底层操作系统和 .NET 运行时已支持 TLS 1.3。这不是 .NET 的限制,而是 ODP.NET 驱动自身的协商策略——它会主动降级到 TLS 1.2,除非你明确告诉它“允许更高版本”。直接改 ServicePointManager.SecurityProtocol 无效,因为 ODP.NET 不走这个全局开关。
实操建议:
- 在连接字符串中添加
Encrypt=true;TrustServerCertificate=false;(强制加密 + 禁用自签名信任,触发证书链验证) - 必须追加
Connection Timeout=30;SSL Server Certificate=;SSL Client Certificate=;等占位字段(部分 Oracle 版本要求非空 SSL 相关参数才启用 TLS 协商) - 最关键的是设置环境变量或配置项:
OracleConfiguration.TlsVersion = "TLS13";(需在AppDomain初始化早期、首次创建OracleConnection前调用) - 若用 .NET 8 的
Microsoft.Extensions.DependencyInjection注册数据访问层,应在Program.cs最顶部加入:
OracleConfiguration.TlsVersion = "TLS13";
Oracle 服务端必须启用 TLS 1.3,且证书链完整
只改客户端没用。Oracle 数据库服务端(19c 或 21c)需满足两个硬性条件:一是监听器配置启用 TLS 1.3,二是证书由受信 CA 签发、包含完整中间证书链。常见错误现象是连接抛出 ORA-28860: Fatal SSL error 或静默断连,抓包会看到 ServerHello 里协商的仍是 TLS 1.2。
检查与修复步骤:
- 登录数据库服务器,确认监听器配置
listener.ora包含:SSL_VERSION = 1.3(不是TLS_VERSION,Oracle 自己的命名) - 运行
lsnrctl status,输出中应有SSL字样且协议列为TCPS - 用
openssl s_client -connect your-db-host:2484 -tls1_3手动测试(端口通常是 2484 而非 1521),成功则显示Protocol : TLSv1.3;失败则看报错是ssl handshake failure(服务端不支持)还是unable to get local issuer certificate(客户端缺中间证书) - 若用 Oracle Wallet,确保 wallet 中导入了根证书 + 全部中间证书,而不仅是终端证书
.NET 8 进程级 TLS 设置对 ODP.NET 无直接影响
很多开发者习惯在 Program.cs 开头写 AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false); 或修改 ServicePointManager.SecurityProtocol,但这对 Oracle.ManagedDataAccess 完全无效。ODP.NET 使用自己的 OpenSSL 绑定(Windows)或 BoringSSL(Linux/macOS),不复用 .NET 的 SslStream 栈。
容易踩的坑:
- 误以为升级到 .NET 8 就自动支持 TLS 1.3 —— 实际仍取决于 ODP.NET 版本(必须 ≥ 23.5,旧版如 19.x/21.x 根本不识别
TLS13字符串) - 在连接池开启状态下反复修改
OracleConfiguration.TlsVersion—— 该属性是静态只读的,运行时修改会被忽略,仅首次设置生效 - 混合部署场景下,同一进程既连 Oracle 又调 HTTPS API,误用全局
HttpClientHandler.ServerCertificateCustomValidationCallback干扰 Oracle 连接验证逻辑
验证是否真走 TLS 1.3 的最可靠方式是抓包
日志或异常信息不会明说用了哪个 TLS 版本。唯一可信的方式是用 Wireshark 抓客户端与 Oracle 服务器之间的 TCPS 流量(端口如 2484),过滤 ssl.handshake,查看 ServerHello 消息中的 Version 字段。注意:Oracle 的 TLS 握手发生在 TCP 连接建立之后,所以要先过滤出目标 IP+端口,再找 TLS 层。
补充提醒:
- 某些 Oracle 云服务(如 ADB)默认禁用 TLS 1.3,需在控制台显式开启“高级 TLS 设置”
- 若应用跑在 Linux Docker 容器中,确保基础镜像含 OpenSSL 1.1.1+(
apk info openssl或dpkg -l | grep openssl),否则 ODP.NET 会 fallback 到 TLS 1.2 -
OracleConfiguration.TlsVersion可设为"TLS12,TLS13"(逗号分隔),但实际协商结果仍由服务端决定,客户端无法强制


















