Oracle.EntityFrameworkCore 6.0+ 不再支持直接传入 OracleOptions，改为通过 UseOracle 扩展方法配合 OracleDbContextOptionsBuilder 进行链式配置，如 EnableBulkInsert() 和 UseOracleSQLCompatibility()，且需区分通用选项（如 EnableRetryOnFailure）与 Oracle 特有选项。
Oracle.EntityFrameworkCore 6.0+ 不再支持 AddDbContext 直接传入 OracleOptions
从 oracle 官方 ef core provider 6.0 开始（对应 .net 6+），oracle.entityframeworkcore 移除了对 oracleoptions 类型的公开构造与配置入口。你无法像旧版那样写 options.useoracle(connectionstring, o => o.enablebulkinsert()) 并在委托里接收 oracleoptions —— 这个类型已内部化，且配置方式彻底转向基于 dbcontextoptionsbuilder 的链式扩展方法。
正确注册 Oracle DbContext 的方式是用 AddDbContext + UseOracle 扩展方法
UseOracle 是由 Oracle.EntityFrameworkCore 提供的扩展方法，它自动完成底层 Oracle 特定选项的初始化。你需要确保已安装正确版本的 NuGet 包，并在 Program.cs 中按以下方式注册：
- 安装
Oracle.EntityFrameworkCore（推荐 7.21.1 或 8.22.1，对应 Oracle Client 19c/21c/23c） - 确认项目中已引用
Microsoft.EntityFrameworkCore和Microsoft.EntityFrameworkCore.Design（开发时需要） - 在
Program.cs中调用services.AddDbContext<YourDbContext>，并在UseOracle委托中只传连接字符串和可选的OracleDbContextOptionsBuilder扩展
示例：
services.AddDbContext<AppDbContext>(options =>
{
options.UseOracle(
configuration.GetConnectionString("OracleDb"),
oracleOptions =>
{
oracleOptions.EnableBulkInsert(); // ✅ 正确：这是 Oracle 提供的扩展方法
oracleOptions.UseOracleSQLCompatibility("12"); // ✅ 如需兼容旧语法
oracleOptions.MaxBatchSize(1000); // ✅ 控制批量操作大小
});
});
注意：oracleOptions 参数类型不是 OracleOptions，而是 OracleDbContextOptionsBuilder —— 它不暴露内部字段，只提供有限但安全的配置入口。
常见错误：把 SQL Server 配置习惯套到 Oracle 上
开发者常因熟悉 SQL Server 而误写以下代码，导致编译失败或运行时报错：
- 试图 new
OracleOptions()：编译报错 —— 类型不可访问 - 在
UseOracle委托里调用options.EnableRetryOnFailure()：这不是 Oracle 提供的方法，应改用EnableRetryOnFailure在options（即DbContextOptionsBuilder）上直接调用 - 混淆
OracleDbContextOptionsBuilder和DbContextOptionsBuilder的作用域：前者只管 Oracle 特有行为（如 bulk、compatibility、lob mapping），后者管通用行为（如日志、超时、重试）
正确分层写法：
services.AddDbContext<AppDbContext>(options =>
{
options
.LogTo(Console.WriteLine, Microsoft.Extensions.Logging.LogLevel.Information)
.EnableRetryOnFailure(maxRetryCount: 3); // ⚠️ 这属于通用 EF Core 行为，放这里
options.UseOracle(connectionString, oracleOpts =>
{
oracleOpts.EnableBulkInsert(); // ✅ Oracle 特有行为，放这里
oracleOpts.UseOracleSQLCompatibility("12");
});
});
连接字符串里别漏掉 Pooling=true 和 Connection Timeout
Oracle 客户端默认启用连接池，但显式声明更稳妥；同时未设超时容易让请求卡死在 DNS 解析或网络抖动环节。生产环境建议：
- 连接字符串中包含
Pooling=true;Connection Timeout=30; - 避免在
UseOracle外部手动设置OracleConfiguration.静态属性（如OracleConfiguration.SqlServerCompatibility）—— 这是全局副作用，且在多 DbContext 场景下不可靠 - 若需自定义
OracleConnection行为（如加监听器），应通过OracleDbContextOptionsBuilder.UseOracleConnection注入工厂，而非硬编码 new
真正容易被忽略的是：Oracle 的连接池在容器化部署（尤其是 Kubernetes）中可能因服务发现延迟或 DNS 缓存导致首次连接失败，这时仅靠 EnableRetryOnFailure 不够，还需配合启动时健康检查或预热逻辑。
