DbSet.FindAsync传参错误排查：Course单键实体传入2个参数

这个问题我之前也碰到过，核心原因是调用FindAsync时参数顺序错误，导致EF Core误将取消令牌当成了第二个主键值处理，最终抛出了那个奇怪的错误。

错误根源详解 #

EF Core的DbSet<T>.FindAsync有两个关键重载需要区分：

• 仅传入主键值的版本：

  ValueTask<TEntity?> FindAsync(params object?[]? keyValues);
  

  这里的params参数允许你传入多个值（对应复合主键场景），所有传入的参数都会被视为主键值。
• 带取消令牌的版本：

  ValueTask<TEntity?> FindAsync(CancellationToken cancellationToken, params object?[]? keyValues);
  

  注意！这个重载里取消令牌是第一个参数，主键值必须放在后面（因为params参数必须是方法的最后一个参数）。

当你写courseRepository.Entities.FindAsync(Id, cancellationToken)时，C#的重载解析会把Id和cancellationToken都打包进params object[] keyValues数组里。EF Core看到两个主键值，但你的Course实体只有Id这一个主键，自然就会抛出Entity type 'Course' is defined with a single key property, but 2 values were passed to the 'DbSet.Find' method的错误。

代码存在的问题 #

你的代码核心问题是混淆了FindAsync带取消令牌重载的参数顺序，没有遵循“取消令牌在前，主键值在后”的规则，导致参数被误解析。

而FirstOrDefaultAsync(c => c.Id == Id, cancellationToken)能正常工作，是因为这个方法的重载定义是：

Task<TEntity?> FirstOrDefaultAsync(Expression<Func<TEntity, bool>> predicate, CancellationToken cancellationToken);

这里第二个参数明确是取消令牌，参数顺序完全匹配，所以不会有歧义。

修复方案 #

有三种可靠的修复方式，你可以根据自己的习惯选择：

方案1：调整参数顺序（最直观） #

把取消令牌放在第一个参数位置，主键值紧随其后：

await courseRepository.Entities.FindAsync(cancellationToken, Id);

方案2：使用命名参数（最清晰，避免重载混淆） #

通过命名参数明确指定每个参数的作用，彻底杜绝重载解析错误：

await courseRepository.Entities.FindAsync(keyValues: Id, cancellationToken: cancellationToken);

方案3：省略取消令牌（如果业务允许） #

如果你的场景不需要取消令牌，可以直接调用仅传主键值的重载：

await courseRepository.Entities.FindAsync(Id);

内容的提问来源于stack exchange，提问作者Mehdi Sheykhveysi