Oracle.EntityFrameworkCore版本需严格匹配数据库版本，连接字符串须显式含User ID和Password，脚手架应加--use-database-names或统一用大写建表，且Program.cs中必须显式注册UseOracle服务。
Oracle.EntityFrameworkCore 包版本必须匹配 Oracle 客户端和数据库版本
装错包是生成模型失败最常见原因。比如用 oracle.entityframeworkcore 7.19.20 连 oracle 12c，会直接报 ora-00904: "t"."owner": invalid identifier —— 因为新版驱动默认启用了对 19c+ 的元数据查询方式，老库不认。
实操建议：
- Oracle 12c → 用
Oracle.EntityFrameworkCore 5.22.150或6.21.120（官方明确标注支持 12.1+） - Oracle 19c/21c → 可用
7.23.19或8.24.10，但注意 EF Core 8 脚手架命令要配--framework net8.0 - 别只看 NuGet 页面写的“supports Oracle”，得翻 GitHub Release Notes 里 “Supported Oracle Database Versions” 小节
scaffold-dbcontext 命令里连接字符串不能省略 USER ID 和 PASSWORD
Oracle 不像 SQL Server 支持 Windows 身份验证，Data Source=... 后面漏掉 User ID= 或 Password=，脚手架会静默失败，最后只生成一个空 DbContext 类，没实体、没 OnModelCreating。
实操建议：
- 连接字符串必须显式包含
User ID=hr;Password=hr;（示例用 hr 用户），不能靠OracleConfiguration.SetConnectionString等运行时配置补救 - 若密码含特殊字符（如
@、;），整个Password=xxx部分要用单引号包裹：Password='p@ss;word' - 推荐先用
sqlplus User/Pass@localhost:1521/XE手动连通，再复制同样凭证到命令中
表名和列名大小写敏感导致生成的 C# 属性名异常
Oracle 默认把未加双引号的标识符转成大写，而 EF Core 脚手架默认按原样映射。结果就是：数据库里建的是 create table emp (name varchar2(50))，生成的类里字段叫 Name；但要是建的是 create table "Emp" ("name" varchar2(50))，生成的属性就变成 name（小写），编译不过。
实操建议：
- 脚手架命令加
--use-database-names参数，让生成器保留原始大小写（对应 Oracle 里带双引号的名称） - 更稳妥的做法是建表时不加双引号，统一用大写命名，然后在
OnModelCreating里用HasColumnName显式指定小写列名（如entity.Property(e => e.Name).HasColumnName("name")） - 如果已有大量带引号的表，
--schema参数必须指定全大写 schema 名（如--schema HR），否则找不到表
生成后 DbContext 构造函数里 UseOracle 需手动补全服务注册
脚手架生成的 DbContext 类里只有构造函数调用 UseOracle，但 ASP.NET Core 项目启动时不会自动注册 Oracle 连接池和类型映射服务，运行时查数据会抛 System.InvalidOperationException: No service for type 'Oracle.EntityFrameworkCore.Storage.Internal.IOracleSingletonOptions' has been registered。
实操建议：
- 在
Program.cs（或Startup.cs）的services.AddDbContext<YourContext>调用里，必须显式传入options => options.UseOracle(connectionString) - 别依赖生成代码里的构造函数注释提示，那个只是示意，不是可执行逻辑
- 如果用了 Oracle UDT 或自定义类型，还得额外加
options.UseOracle(...).ReplaceService<IRelationalTypeMappingSource, OracleTypeMappingSource>()
Oracle 的大小写规则、驱动版本绑定、连接字符串细节这三块，改一处常牵出两处报错。尤其当 DBA 给你一个已存在的 schema，先花五分钟确认表名是否带双引号、用户权限是否包含 SELECT_CATALOG_ROLE，比反复跑 scaffold 命令快得多。
