必须使用 Oracle.ManagedDataAccess 驱动，因其是官方唯一推荐、纯托管、支持 .NET 8 的 Oracle 数据库访问方案；System.Data.OracleClient 已被彻底移除，引用会导致编译或运行时失败。
.net 8 调用 oracle 数据库本身不涉及“api 调用”——oracle 是数据库，不是 http 服务。你真正想做的，是 在 .net 8 web api 项目中安全、稳定地访问 oracle 数据库。直接用 system.data.oracleclient 不行：它早在 .net framework 4.0 后就被标记为过时，.net core / .net 5+ 完全移除，编译就报错。
必须换用现代、受支持的驱动，且要避开已淘汰路径。
为什么不能用 System.Data.OracleClient
这个命名空间只存在于旧版 .NET Framework（≤4.8），依赖 Windows 平台和本地 Oracle 客户端 DLL（如 oci.dll）。.NET 8 是跨平台的，运行时根本不加载 System.Data.OracleClient —— 项目一启动就会抛出 System.IO.FileNotFoundException: Could not load file or assembly 'System.Data.OracleClient'。强行引用只会让构建失败或运行时报类型缺失。
必须用 Oracle.ManagedDataAccess 或 ODP.NET Core
官方唯一推荐、持续更新、纯托管（无需安装 Oracle Client）、支持 .NET 8 的驱动是 Oracle.ManagedDataAccess（ODP.NET Core 版本）。NuGet 包名就是 Oracle.ManagedDataAccess，不是 Oracle.DataAccess（那是旧版非托管驱动）。
- 安装命令：
dotnet add package Oracle.ManagedDataAccess - 连接字符串示例：
"User Id=myuser;Password=mypass;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myoracleserver)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)))"，也可用简写"Data Source=localhost:1521/ORCL;User Id=myuser;Password=mypass;" - 代码中用
using Oracle.ManagedDataAccess.Client;，而非System.Data.OracleClient - 注意：
OracleConnection、OracleCommand等类型都来自这个命名空间，行为与旧版接近但不完全兼容（比如参数前缀是冒号:而非 @）
SQLSugar 配合 Oracle.ManagedDataAccess 才是 .NET 8 正确姿势
直接写 ADO.NET 容易漏关连接、难做日志、事务分散。用 ORM 更稳妥，而 SQLSugar 在 Oracle 场景下比 EF Core 更轻量、更少配置陷阱。
- 先装两个包：
dotnet add package SqlSugarCore+dotnet add package Oracle.ManagedDataAccess -
Program.cs中注册（注意 DbType 必须设为DbType.Oracle）：builder.Services.AddScoped<ISqlSugarClient>(s => new SqlSugarClient(new ConnectionConfig() { ConnectionString = builder.Configuration["ConnectionStrings:Oracle"], DbType = DbType.Oracle, IsAutoCloseConnection = true, InitKeyType = InitKeyType.Attribute })); - Controller 中注入使用：
private readonly ISqlSugarClient _db;，然后直接_db.Ado.UseTransaction()或_db.Queryable<User>().Where(x => x.Id == 1).First() - 关键点：SQLSugar 不会自动帮你装 Oracle 驱动 —— 缺少
Oracle.ManagedDataAccess，运行时会报System.ArgumentException: The provider 'Oracle' is not supported
Oracle 连接池和字符集最容易翻车
Oracle 默认连接池开启，但 .NET 8 下若连接字符串没显式控制，可能因超时或空闲连接堆积导致 ORA-12519: TNS:no appropriate service handler found；中文乱码则多因服务端字符集（如 ZHS16GBK）和客户端未对齐。
- 连接字符串加
Connection Timeout=30;Pooling=true;Min Pool Size=1;Max Pool Size=10;显式管理池大小 - 确保 Oracle 服务端字符集与
Oracle.ManagedDataAccess兼容：若服务端是AL32UTF8，驱动默认 UTF-8 行为正常；若是ZHS16GBK，需在连接字符串加Unicode=true;并统一代码中字符串编码处理 - 执行含中文的 SQL 时，避免拼接字符串，一律用参数化查询：
cmd.CommandText = "SELECT * FROM users WHERE name = :name"; cmd.Parameters.Add(new OracleParameter("name", "张三"));
Oracle 的坑不在语法，而在环境链路：驱动版本、连接池策略、字符集声明、权限模型（比如 ACL 控制网络调用）全都得对齐。少一个环节，ORA- 错误就来得又急又静。
