FirstOrDefault是EF Core查询单条记录的常用方法,匹配则返回首项,否则返回null或默认值;推荐加where条件、用Select优化字段查询,并在Web应用中优先使用FirstOrDefaultAsync异步版本。

FirstOrDefault 是 EF Core 中最常用的查询单条记录的方法,适用于“取第一个匹配项,没找到就返回默认值”的场景。
FirstOrDefault 的基本用法
它会生成 SELECT TOP 1 ...(SQL Server)或等效的 LIMIT 查询,只查一条数据,效率高。如果数据库中没有匹配项,不会报错,而是返回 null(引用类型)或类型的默认值(如 0、false)。
- 查询存在时返回实体对象;不存在时返回
null(例如Blog类型) - 查询值类型(如
int)需配合Select使用,否则编译不通过 - 不带条件直接调用(
context.Blogs.FirstOrDefault())会取表中任意一条(通常第一条),慎用
带条件的 FirstOrDefault(最常用)
推荐始终加 where 条件,避免意外取到错误数据:
var blog = context.Blogs.FirstOrDefault(b => b.Id == 123);
等价于 SQL:SELECT TOP 1 * FROM Blogs WHERE Id = 123。如果 ID 为 123 的博客不存在,blog 就是 null,可安全判断:
if (blog != null)
{
Console.WriteLine(blog.Name);
}FirstOrDefault + Select:查单个字段
如果只要一个字段(比如只查用户名),用 Select 配合 FirstOrDefault 更高效:
-
string name = context.Users.FirstOrDefault(u => u.Id == 5)?.Name;(先查整行再取 Name) -
string name = context.Users.Where(u => u.Id == 5).Select(u => u.Name).FirstOrDefault();(只查 Name 字段,推荐)
后者生成的 SQL 是 SELECT TOP 1 Name FROM Users WHERE Id = 5,更节省网络和内存。
FirstOrDefaultAsync:异步版本(推荐用于 Web 应用)
在 ASP.NET Core 等异步环境中,优先用 FirstOrDefaultAsync 防止线程阻塞:
var product = await context.Products.FirstOrDefaultAsync(p => p.Sku == "ABC123");
记得方法签名要加 async,返回类型为 Task,调用处用 await。
基本上就这些。用对 FirstOrDefault,既能安全取单条,又不拖慢查询。










