.NET Core搭配Oracle EF Core调用SaveChanges报op_Equality参数不匹配错误

问题根因 #

这个错误是Oracle EntityFramework Core 2.19版本的典型触发场景：EF Core在生成变更追踪的SQL语句时，需要对实体的字段做相等性比较，op_Equality是C#中==运算符对应的方法名，报错说明比较的两个操作数类型不匹配，找不到对应参数的相等运算符重载。
报错不是你业务代码里写的==触发，是EF内部执行SaveChanges生成SQL、校验实体状态的过程中触发。

排查步骤 #

• 第一步：核对Notification实体属性和数据库表的字段类型
  重点校验以下容易出问题的类型：
  • 数值类字段：Oracle数据库的NUMBER类型默认映射到C#的decimal，如果你的主键/外键字段在数据库是NUMBER(10)这类整数格式，实体属性用了int/long类型，没有显式配置类型转换，相等比较时就会出现decimal和int类型不匹配的问题
  • 字符串类字段：如果数据库字段是CHAR/NCHAR定长字符串，实体属性没有显式标注[Column(TypeName = "char(xx)")]，EF会默认按变长字符串VARCHAR2处理，比较时也会触发类型不匹配
• 第二步：检查Notification实体的自定义相等逻辑
  如果你自己重载了Notification类的==/!=运算符，检查重载方法的参数是不是严格为Notification类型：如果参数用了object/泛型类型，EF变更追踪调用相等判断时就会找不到匹配的op_Equality方法。
• 第三步：输出生成的SQL定位问题字段
  在_dbcontext.SaveChanges()之前加入如下代码，打印EF生成的执行SQL，直接查看=两边的操作数类型就能定位不匹配的字段：

  _dbcontext.GetService<ILoggerFactory>().AddConsole(
      (category, level) => category == DbLoggerCategory.Database.Command.Name && level == LogLevel.Information, 
      true);
  

解决方案 #

• 类型不匹配的场景：在OnModelCreating中显式配置字段映射和类型转换即可，示例如下：

  modelBuilder.Entity<Notification>()
      .Property(p => p.NotificationId) // 替换为你不匹配的字段名
      .HasColumnType("NUMBER(10)") // 替换为数据库实际的字段类型
      .HasConversion<int>(); // 替换为实体属性的实际类型
  

• 自定义相等重载的场景：要么删除自定义的==/!=重载，要么修改重载方法保证两个输入参数都是Notification类型，重载逻辑不要涉及未加载的导航属性。
• 版本不兼容的场景：保证你的所有Microsoft.EntityFrameworkCore相关依赖包的版本统一为2.1.1，和Oracle EF Core 2.19的适配版本一致，避免跨版本的类型兼容问题。

内容的提问来源于stack exchange，提问作者C Sharper