DbFunctions 用于在 IQueryable 查询中调用数据库原生函数以实现查询下推，须通过 EF.Functions 在 Where/OrderBy/Select 中使用，不可在客户端执行或 .ToList() 后调用，不同数据库支持度不同，自定义函数需注册并确保数据库端存在。
EF Core 的 DbFunctions 用于在 LINQ 查询中调用数据库原生函数（如字符串处理、日期计算、数学运算等），让查询能下推到数据库执行，避免把大量数据拉到内存再处理。
通过 EF.Functions 访问数据库函数
EF Core 将常用数据库函数封装在 DbContext 的 EF.Functions 属性中。必须在 LINQ 查询的 Where、OrderBy、Select 等方法中使用，不能在 C# 代码中直接调用。
- 确保你的查询是
IQueryable（即未触发执行），否则会报错或回退到客户端计算 - 不同数据库支持的函数不同，例如
Like在 SQL Server 和 SQLite 中可用，但写法和行为可能略有差异 - 使用前确认当前数据库提供程序是否支持该函数（比如 PostgreSQL 需要 Npgsql 扩展）
常用 DbFunctions 示例
以下是在 Where 或 Select 中的典型用法：
-
字符串匹配：
context.Users.Where(u => EF.Functions.Like(u.Name, "%admin%")) -
大小写不敏感比较（SQL Server）：
EF.Functions.Collate(u.Name, "SQL_Latin1_General_CP1_CI_AS") -
日期操作：
EF.Functions.DateDiffDay(u.CreatedAt, DateTime.Today) > 7 -
全文搜索（SQL Server）：
EF.Functions.Contains(u.Description, "error") -
PostgreSQL 扩展函数（需引用 Npgsql.EntityFrameworkCore.PostgreSQL）：
EF.Functions.ILike(u.Email, "[a-z]%@example.com")
自定义数据库函数（高级用法）
如果内置函数不够用，可通过 ModelBuilder.HasDbFunction 注册自定义标量函数（需数据库已存在该函数）：
- 先在数据库中创建函数（如 SQL Server 的
CREATE FUNCTION dbo.CalculateAge） - 在
OnModelCreating中注册：modelBuilder.HasDbFunction(typeof(MyDbFunctions).GetMethod(nameof(MyDbFunctions.CalculateAge))) - 定义静态方法并标记
[DbFunction]特性，EF 才能识别并翻译成 SQL - 注意：自定义函数不支持客户端模拟，必须确保数据库端存在且签名一致
注意事项与避坑点
DbFunctions 很实用，但也容易出错：
- 不能在
.ToList()、.AsEnumerable()之后使用，否则会抛InvalidOperationException - 部分函数（如
Random、NewId）每次查询结果可能不同，慎用于排序或分页 - SQLite 对函数支持较弱，很多
EF.Functions方法在 SQLite 下不可用或被模拟为客户端计算 - 调试时可启用 EF 日志（
LogTo(Console.WriteLine)）查看最终生成的 SQL，确认函数是否成功下推
基本上就这些。用好 DbFunctions 能写出更高效、更贴近数据库能力的查询，关键是在 IQueryable 链路里用，别让它“漏”到内存里。
