必须安装 oracle.entityframeworkcore 和 oracle.manageddataaccess.core 两个 nuget 包,版本需严格对齐;连接字符串须用完整描述符而非 tns 别名;实体类映射需统一使用大写命名或启用 usequotedidentifiers();schema 应通过 totable("表名","schema") 或 hasdefaultschema("schema") 显式指定。

能连上,但大概率第一次跑就报错——不是驱动没装对,就是连接字符串或大小写没对齐。
必须装哪两个 NuGet 包
只装 Oracle.EntityFrameworkCore 不行,它依赖底层驱动。漏掉 Oracle.ManagedDataAccess.Core 会导致运行时抛出 System.IO.FileNotFoundException: Could not load file or assembly 'Oracle.ManagedDataAccess'。
-
Oracle.EntityFrameworkCore:提供UseOracle()扩展方法和 EF Core 映射逻辑 -
Oracle.ManagedDataAccess.Core:纯 .NET 实现的 Oracle 客户端,不依赖本地 Oracle Client
两者版本要对齐。比如 EF Core 6.x 对应 Oracle.EntityFrameworkCore 6.21.60 + Oracle.ManagedDataAccess.Core 3.21.60;EF Core 8.x 推荐用 8.22.10 系列。混用高/低版本可能触发 Method not found 异常。
连接字符串怎么写才不报 ORA-12154
别用 TNS 别名(如 Data Source=ORCL),除非你确认项目里有且仅读取了 tnsnames.ora 文件——.NET Core 默认不加载它。直接写完整描述符最稳:
@"Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)));User Id=SCOTT;Password=tiger;"
常见坑点:
- HOST 写成
localhost但 Oracle 在 Docker 或远程服务器上 → 改为实际 IP - SERVICE_NAME 写成 SID(比如
ORCL是 SID,ORCLPDB1才是 CDB/PDB 的 SERVICE_NAME)→ 查SELECT value FROM v$parameter WHERE name = 'service_names'; - 密码含特殊字符(如
@、;)→ URL 编码或改用双引号包裹整个字符串
实体类字段映射为什么总查不到数据
Oracle 默认把所有未加引号的标识符转成大写,而 EF Core 默认生成小写表名/列名。结果就是 context.People.ToList() 去查 PEOPLE 表,但实体类里写了 [Table("people")] → 查空。
解决方式只有两种,选一个坚持到底:
- 全用大写 +
[Table("PEOPLE")]/[Column("ID")],配合数据库真实命名 - 启用带引号的标识符:在
UseOracle()配置里加b.UseQuotedIdentifiers(),这样 EF Core 会把People映射成"People"(保留大小写)
注意:UseQuotedIdentifiers() 会让所有表名、列名加双引号,后续手写 SQL 或用 PL/SQL 工具时也得加引号,否则报 ORA-00942: table or view does not exist。
Schema 怎么指定才不踩坑
Oracle 的 schema 名 = 用户名。如果你用 User Id=SCOTT 连接,那默认 schema 就是 SCOTT。但 EF Core 不会自动把 modelBuilder.Entity<person>().ToTable("PEOPLE")</person> 解释为 SCOTT.PEOPLE,它只查当前 session 默认 schema 下的表。
显式指定 schema 的正确姿势:
- 在
ToTable()里传两个参数:modelBuilder.Entity<person>().ToTable("PEOPLE", "SCOTT")</person> - 或全局设置默认 schema:
modelBuilder.HasDefaultSchema("SCOTT")(适用于整个 DbContext 只操作一个 schema)
别在连接字符串里加 Settings Schema=SCOTT —— 这是旧版 ODP.NET 的写法,EF Core 的 UseOracle() 不识别它,加了等于白加。
真正麻烦的不是连上,而是连上之后发现表名对不上、字段查不到、null 值行为异常——这些都得靠日志开出来看 EF 生成的 SQL,再比对 Oracle 实际执行计划。别跳过这一步。











