.NET 8 默认不认 Oracle Wallet 因其 ODP.NET Core 使用纯托管协议,不加载本地 Oracle Client,故无法读取 sqlnet.ora 中的 WALLET_LOCATION;必须在应用启动最早处(如 Program.cs 第一行)用 OracleConfiguration.WalletLocation 设置绝对路径指向含 cwallet.sso 的目录,并确保权限为600,连接字符串需用 TCPS 协议及完整 DESCRIPTION 语法。

为什么 .NET 8 默认不认 Oracle Wallet?
因为 .NET 8 的 Oracle.ManagedDataAccess(ODP.NET Core)默认走纯托管协议,不加载本地 Oracle Client,也就无法读取 sqlnet.ora 和 tnsnames.ora 中的 WALLET_LOCATION 配置。它只支持通过连接字符串显式指定 wallet 路径,且必须用 OracleConfiguration.WalletLocation 静态属性提前设置——不是环境变量,也不是配置文件项。
必须用 OracleConfiguration.WalletLocation 设置绝对路径
在 Program.cs 或应用启动最早处(比如 main 入口第一行),必须调用:
OracleConfiguration.WalletLocation = @"/absolute/path/to/wallet/directory";
这个路径是包含 cwallet.sso 的目录(不是文件本身),且必须是绝对路径。Windows 上可用 @@"C:\oracle\wallet";Linux/macOS 下注意权限:cwallet.sso 文件需为 600(chmod 600 cwallet.sso),否则报 ORA-28860。
- 不能写相对路径(如
"./wallet"或"../config/wallet") - 不能用
Environment.GetFolderPath()动态拼接后赋值——ODP.NET 在首次new OracleConnection()前就已读取该静态属性 - Docker 容器中要确保挂载路径真实存在,且进程用户有读权限:运行
ls -l /wallet/cwallet.sso必须能看见
连接字符串必须用 TCPS + 完整 DESCRIPTION 语法
自治数据库(ADB)或启用 mTLS 的云库,必须用 tcps 协议、端口 2484,且不能简化成 EZCONNECT 格式。正确写法:
"Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=adb.us-ashburn-AD1.oraclecloud.com)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=mydb_high.adb.oraclecloud.com)));User Id=ADMIN;Password=mypass;"
关键点:
-
HOST和SERVICE_NAME必须从 ADB 控制台“连接信息”页复制,大小写敏感,带.adb.oraclecloud.com后缀 - 不能省略
CONNECT_DATA块,也不能把SERVICE_NAME换成SID - 用户名密码仍可写在连接串里——这和 Java JDBC 不同;Wallet 只负责 TLS 证书交换,不替代登录凭证
- 如果目标库是传统 Oracle DB(非 ADB)且配置了 TCPS 监听器,同样适用此格式,但需确认监听器实际监听
tcps协议
别混用 Managed 和 Unmanaged 驱动
如果你在项目中同时引用了 Oracle.ManagedDataAccess 和 Oracle.ManagedDataAccess.Core,或错误启用了 Oracle.DataAccess(旧版 ODP.NET),会触发类型冲突或静默忽略 wallet 设置。只保留一个:
- 推荐用
Oracle.ManagedDataAccess(最新版 ≥ 23.x),它支持 .NET 8、TCPS 和 wallet 自动识别 - 禁用
OracleConfiguration.UseOci(即不要设为true),否则会尝试加载本地 OCI 库,而 .NET 8 环境通常没装 Instant Client - 若必须用 OCI 模式(例如需要高级特性如 AQ 或 RAC 支持),则必须在系统 PATH 中提供匹配版本的
oci.dll(Windows)或libclntsh.so(Linux),且TNS_ADMIN环境变量需指向含sqlnet.ora的目录
最易被忽略的是:wallet 路径设置必须早于任何 Oracle 类型的静态初始化,哪怕只是引用了 OracleConnection 类型——.NET 的类型加载机制会让 wallet 配置失效。


















