必须安装 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") 解释为 SCOTT.PEOPLE，它只查当前 session 默认 schema 下的表。
显式指定 schema 的正确姿势：
- 在
ToTable()里传两个参数：modelBuilder.Entity<Person>().ToTable("PEOPLE", "SCOTT") - 或全局设置默认 schema：
modelBuilder.HasDefaultSchema("SCOTT")（适用于整个 DbContext 只操作一个 schema）
别在连接字符串里加 Settings Schema=SCOTT —— 这是旧版 ODP.NET 的写法，EF Core 的 UseOracle() 不识别它，加了等于白加。
真正麻烦的不是连上，而是连上之后发现表名对不上、字段查不到、null 值行为异常——这些都得靠日志开出来看 EF 生成的 SQL，再比对 Oracle 实际执行计划。别跳过这一步。
