EntityFrameworkCore实现Oracle通用仓储时Insert方法报错咨询

错误根因 #

• DbSet<TEntity>.Add() 方法的返回值类型为 EntityEntry<TEntity>，而非你代码预期的 TEntity，类型不匹配是直接触发编译/运行报错的核心原因。
• Add是纯同步内存操作，仅将实体加入EF Core变更追踪队列，没有对应的异步实现，强行套Task.Run属于无意义的线程池资源浪费，同时DbContext本身不是线程安全结构，跨线程调用极易引发并发访问异常。
• 若你需要将数据持久化到Oracle库，Add操作本身不会触发数据库写入，还需额外调用SaveChangesAsync同步变更。

修复代码 #

版本1：插入后立即持久化（仓储自行管理保存） #

public async Task<TEntity> Insert(TEntity value)
{
    var entityEntry = _selector(_dbContext).Add(value);
    await _dbContext.SaveChangesAsync();
    return entityEntry.Entity;
}

版本2：适配工作单元模式（仅加入追踪，上层统一提交） #

// 无异步必要，全部为内存操作
public TEntity Insert(TEntity value)
{
    return _selector(_dbContext).Add(value).Entity;
}

额外注意事项 #

如果使用官方Oracle.EntityFrameworkCore驱动，需提前配置好实体的主键生成策略，匹配Oracle的序列、自增列语法，否则SaveChanges阶段会抛出主键约束冲突报错。
如果开启了全局事务，需保证SaveChanges操作在事务作用域内执行，避免数据不一致。

内容的提问来源于stack exchange，提问作者Srikant suryawanshi