Oracle.ManagedDataAccess.Client 的 oracle.manageddataaccess.client 配置节仅适用于 .NET Framework，.NET Core/5+ 不支持该 XML 配置机制，必须改用 appsettings.json 的 ConnectionStrings、TNS_ADMIN 环境变量及代码中服务注入等方式配置。
appsettings.json 里不能直接配 oracle.manageddataaccess.client 节
oracle.manageddataaccess 的 oracle.manageddataaccess.client 配置节是 .net framework 时代的产物，依赖 configurationmanager 和 configsections 机制。.net core / .net 5+ 完全不用 web.config 或 app.config，所以这个 xml 节点在 appsettings.json 里写无效，也不会被驱动读取。
你看到的旧文档里所有 <oracle.manageddataaccess.client> 块（含 <dataSources>、<settings>）都只对 .NET Framework 生效。在 .NET Core 中，这些配置必须通过其他方式落地：
- 连接字符串本身写死或从
appsettings.json的ConnectionStrings段读取（支持 Easy Connect 或完整描述符） -
TNS_ADMIN环境变量替代配置节里的<setting name="TNS_ADMIN"> - 数据源别名（如
alias="MyDB"）无法在 .NET Core 中通过配置声明，只能手动拼接完整连接描述符，或自己实现别名映射逻辑 - TraceFile 等诊断配置——根本不可用；
OracleConfiguration.TraceFile是只读属性，且整个 tracing 体系未移植到 .NET Core 版本
.NET Core 连接字符串怎么写才真正生效
Managed 驱动在 .NET Core 下只认连接字符串里的参数，且有明确的有效性边界。写错参数不会报错，但可能静默失效或触发兼容路径。
以下参数在 .NET Core + Oracle.ManagedDataAccess（≥ 3.21.10，即对应 Oracle 21c 及以上）中确认有效：
-
Data Source：支持两种格式
— Easy Connect："mydb.example.com:1521/ORCLPDB1"
— 完整描述符："(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))" -
User Id和Password：必需，不支持 OS 认证 -
Connection Timeout：单位秒，例如30 -
Pooling：设为false可关闭连接池（调试连接泄漏时有用） -
Statement Cache Size：设为0关闭语句缓存，避免首次查询触发额外元数据请求
以下参数已废弃或无效，写了也白写：
-
Unicode=True（默认就是 true） -
Persist Security Info=False（驱动强制忽略） -
Load Balancing=True（需配合 RAC 配置，单节点下不生效） -
Failover=true（.NET Core 版本尚未实现客户端故障转移逻辑）
如何让 TNSNAMES.ORA 在 .NET Core 中起作用
Managed 驱动支持 TNS 解析，但不走配置文件，只认环境变量 TNS_ADMIN。它必须指向一个包含 tnsnames.ora 的目录，且该文件权限需允许进程读取。
使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。
常见错误现象：程序启动时抛 Oracle.ManagedDataAccess.Client.OracleException: ORA-12154: TNS:could not resolve the connect identifier specified，本质是 TNS_ADMIN 没设对，或路径下没有可读的 tnsnames.ora。
- Windows：在项目启动前执行
Environment.SetEnvironmentVariable("TNS_ADMIN", @"C:\oracle\network\admin");，建议放在Program.cs最开头 - Linux/Docker：启动容器时加
-e TNS_ADMIN=/etc/oracle/network/admin，并确保挂载的目录里有tnsnames.ora - 注意：路径末尾不要加反斜杠（
\），否则某些版本驱动会解析失败 - 验证是否生效：运行时打印
Environment.GetEnvironmentVariable("TNS_ADMIN")，再尝试用别名连接，如Data Source=MyDB
为什么 Entity Framework Core 不需要 <dbProviderFactories>
EF Core 的驱动注册完全基于服务注入模型，和 .NET Framework 时代的 DbProviderFactories 无关。你不需要、也不应该在 appsettings.json 或任何地方模拟那个 XML 节。
正确做法是在 Program.cs 中调用：
builder.Services.AddDbContext<AppDbContext>(options =>
options.UseOracle(builder.Configuration.GetConnectionString("Oracle")));
前提是 NuGet 已安装 Oracle.EntityFrameworkCore（不是 Oracle.ManagedDataAccess 单独包），且该包版本与 EF Core 主版本匹配（例如 EF Core 7.x 对应 Oracle.EntityFrameworkCore 7.21.10）。若只装了 Oracle.ManagedDataAccess，EF Core 会找不到 provider 并报 “No database provider has been configured”。
容易被忽略的一点：Oracle.EntityFrameworkCore 内部引用了对应版本的 Oracle.ManagedDataAccess，二者版本必须对齐。混用 6.x 和 7.x 的包会导致运行时类型加载失败或连接超时无提示。
