如何在.NET 8中通过Wallet连接Oracle数据库

风瑶小哥_1152

风瑶小哥_1152

2026-11-19

353人浏览

原创

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

如何在.net 8中通过wallet连接oracle数据库

为什么 .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 格式。正确写法:

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
"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 配置失效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

1181

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

3573

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

3570

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

2029

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2653

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

3729

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

5049

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

277

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

986

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程