ORA-00904错误主因是标识符无效,需依次确认字段是否存在、大小写是否匹配(Oracle默认转大写,双引号定义的小写字段查询时必须加双引号)、EF Core映射是否显式指定列名、目标Oracle版本是否兼容FALSE/TRUE字面量、标识符长度是否超30字节,以及驱动是否混用。
ORA-00904 报错时先确认字段是否存在且大小写匹配
oracle 默认将未加引号的标识符转为大写,但如果你建表时用了双引号定义小写字段(如 "user_name"),查询时就必须用 "user_name",不能写成 user_name 或 user_name。ef core 自动生成的 sql 通常不带引号,一旦模型映射的属性名与数据库实际字段名大小写不一致,就会触发 ora-00904。
常见表现:实体类里写 UserName,数据库字段却是 "user_name";或反过来,数据库是 USER_NAME,但 EF 查询时生成了 username(小写无引号)。
- 用 PL/SQL 或
SELECT column_name FROM all_tab_columns WHERE table_name = 'YOUR_TABLE'查看真实字段名和大小写 - 在实体类上用
[Column("USER_NAME")]显式指定大写字段名,避免依赖默认映射 - 若字段确为小写带引号,必须在
OnModelCreating中用HasColumnName("user_name")并确保字符串字面量带双引号(EF Core 会原样保留)
Oracle 版本兼容性导致的 FALSE/TRUE 标识符错误
Oracle 23c 开始原生支持 FALSE 和 TRUE 字面量,但 19c 及更早版本不识别——EF Core 在生成布尔条件(如 .Where(x => x.IsActive == false))时,可能直接输出 WHERE ... = FALSE,结果报 ORA-00904: “FALSE” 标识符无效。
这不是模型或 SQL 写错了,而是驱动层按高版本语法生成了低版本 Oracle 不认的字面量。
- 必须在
UseOracle配置中显式声明目标数据库版本,例如UseOracleSQLCompatibility("19")或UseOracleSQLCompatibility(OracleSQLCompatibility.DatabaseVersion19) - 不要依赖自动探测;即使你连的是 19c,EF Core 默认可能按 21c 行为生成 SQL
- 验证方式:开启 EF 日志,看生成的 SQL 是否还含
FALSE/TRUE;替换成0/1即说明生效
标识符过长(ORA-00972)引发的“无效标识符”连锁反应
Oracle 11g/12c 对对象名长度限制为 30 字节,而 EF Core Code First 自动拼接的约束名、索引名、外键名(如 FK_Orders_CustomerId_Customers_Id)很容易超长。一旦创建失败,后续迁移或查询可能因依赖这些不存在的对象而报“标识符无效”,表面看像字段错,实则是底层 DDL 没跑通。
这个错误常被误判为模型定义问题,但根源在命名策略失控。
- 在
OnModelCreating中设置modelBuilder.Model.Relational().MaxIdentifierLength = 30(EF Core 5+)或modelBuilder.Model.SetMaxIdentifierLength(30)(EF Core 3.1) - 配合使用
[Table("SHORT_NAME")]、[Column("COL")]缩短实体和属性名,比依赖自动截断更可控 - 检查迁移脚本生成的 SQL,搜索
CREATE INDEX或ADD CONSTRAINT后的长名称,确认是否已截断且保持唯一性
连接字符串里混入 Devart 等第三方驱动特有参数
有些项目会同时引用 Oracle.ManagedDataAccess 和 Devart.Data.Oracle.EFCore,但两者的连接字符串语法不兼容。比如 Devart 支持 licensekey=xxx,而 ODP.NET 不识别,解析时直接报“licensekey 是无效的连接字符串属性”,接着整个连接失败,后续所有操作都可能以“标识符无效”等模糊错误呈现。
这类问题往往出现在混合使用 Dapper(用 Devart)和 EF Core(用 ODP.NET)的项目中。
- 统一驱动:EF Core 只用
Oracle.EntityFrameworkCore(官方包),Dapper 改用Oracle.ManagedDataAccess的OracleConnection - 删掉连接字符串中所有非 ODP.NET 官方文档列出的参数,如
licensekey、persist security info - 如果必须用 Devart,请确保 EF Core 全链路(包括 DbContext 构造、迁移工具)都引用其对应 EF Core Provider 包,而非混搭











