如何配置EF Core 8适配Oracle 19c-Oracle-PHP中文网

ef core 8 连 oracle 19c 需用 oracle.entityframeworkcore 8.24.10，指定 --framework net8.0；连接字符串须含 service_name、禁用 tns 别名；dbcontext 配置需显式设 schema、nls 格式及 useoraclesqlcompatibility("19")；脚手架须加 --schema 参数并确保生成的表名/列名全大写且与 dba_tables 一致。

如何配置ef core 8适配oracle 19c

EF Core 8 连 Oracle 19c 能跑通，但默认配置大概率查得慢、建模失败、甚至连不上——问题不在版本不兼容，而在 Oracle.EntityFrameworkCore 提供器对 .NET 8 的适配细节没显式对齐，且 Oracle 侧的 NLS、Schema、连接字符串格式稍有偏差就会立刻报错或静默降级。

确认 NuGet 包版本与 .NET Framework 目标匹配

EF Core 8 必须用支持它的 Oracle 提供器版本，不是“最新版”就行：

Oracle.EntityFrameworkCore 8.24.10 是目前唯一明确声明支持 EF Core 8 + .NET 8 的稳定版（截至 2026 年 7 月）
安装时必须指定 --framework net8.0，否则脚手架命令（dotnet ef dbcontext scaffold）会因目标框架不匹配失败
别装 Oracle.ManagedDataAccess 单独包：8.24.10 已内置所需驱动，重复引用可能引发 System.TypeLoadException

连接字符串必须显式包含 SERVICE_NAME 且禁用 TNS 别名

EF Core 8 下 Oracle 提供器对 tnsnames.ora 解析不稳定，尤其在容器或 CI 环境中，TNS 别名常返回 ORA-12154: TNS:could not resolve the connect identifier：

oracle知识库

oracle知识库下载

下载

写死完整连接描述符，例如：Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)));User Id=SCOTT;Password=tiger;
确保 SERVICE_NAME 与 sqlplus / as sysdba 中执行 SELECT value FROM v$parameter WHERE name = 'service_names'; 返回值一致
Windows 上若用 Instant Client，PATH 必须包含解压路径（如 C:\oracle\instantclient_19_15），且该路径下存在 oci.dll

DbContext 配置必须强制 Schema 和 NLS 参数

Oracle 不区分大小写的表名假象只在未加引号时成立；一旦 EF 生成带双引号的 SQL（如 "DEPT"），就触发大小写敏感和隐式字符集转换：

在 OnModelCreating 中调用 modelBuilder.HasDefaultSchema("SCOTT")，否则默认生成 "scott"（小写）导致找不到表
连接字符串末尾追加 ;NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS';NLS_TIMESTAMP_FORMAT='YYYY-MM-DD HH24:MI:SS.FF'，否则日期字段查询会插入 TO_DATE() 导致索引失效
显式启用 SQL 兼容模式：optionsBuilder.UseOracle(connectionString, b => b.UseOracleSQLCompatibility("19"))，避免 EF 生成 Oracle 12c 旧语法

脚手架生成模型时要绕过大小写陷阱

Oracle 19c 默认把未加引号的标识符转为大写，但 EF Core 8 脚手架默认按小写生成类名和属性名，直接导致 SELECT * FROM dept 找不到表：

运行 scaffold 命令时加 --schema SCOTT 参数，否则只扫当前用户默认 schema（通常是连接用户小写名）
生成后手动检查每个实体类上的 [Table("DEPT")] 和 [Column("DEPTNO")] —— 名字必须全大写，且与 DBA_TABLES 中实际名称完全一致
如果表名含特殊字符或小写字母（比如创建时用了 CREATE TABLE "user_log" (...) ），必须保留引号并在 [Table] 中原样写出：[Table("\"user_log\"")]

真正卡住人的往往不是“连不上”，而是“连上了但查不出数据”或“查得慢到超时”——这时候八成是 NLS 格式没对齐、Schema 没锁定、或者脚手架生成的类名和 Oracle 实际对象名大小写不匹配。盯住日志里有没有 TO_DATE、执行计划是不是 FULL TABLE SCAN、生成的 SQL 里表名带不带引号，比反复升级包更管用。