EF Core 自定义数据库函数映射需两步：声明带 [DbFunction] 特性的 public static 方法，并在 OnModelCreating 中显式调用 HasDbFunction 注册；否则报错或客户端求值。
EF Core 自定义数据库函数映射，核心是让 C# 代码中的静态方法“翻译”成 SQL 中的原生数据库函数调用，而不是在内存中执行。关键在于两步：声明方法 + 显式注册。不靠约定，必须手动配置 HasDbFunction，否则 EF Core 不识别、会报错或退化为客户端求值。
静态方法要写对：签名即契约
方法必须是 public static，返回类型和参数类型需严格匹配数据库函数的 SQL 类型（如 SQL Server 的 DECIMAL(18,2) 对应 C# 的 decimal，FLOAT 对应 double）。方法体不用实现，只抛异常即可：
-
[DbFunction("MyUdf", Schema = "dbo")]—— 特性中标明函数名和 Schema，名称必须与数据库中创建的一致 - 方法名可以不同，但推荐保持一致，降低维护成本
- 不能有重载；同名方法多个签名会导致映射歧义
OnModelCreating 中必须调用 HasDbFunction
仅加特性不够，EF Core 6+ 要求显式注册，否则查询时找不到映射，直接报 InvalidOperationException: The function 'xxx' was not found：
- 使用
modelBuilder.HasDbFunction(typeof(YourDbContext).GetMethod(nameof(YourMethod))) - 如果方法不在 DbContext 类里（比如放在工具类中），就用对应类型的
typeof(YourHelperClass) - 可链式调用
.HasName("xxx").HasSchema("yyy")覆盖特性中的设置（用于调试或适配多库场景）
标量函数 vs 表值函数：用法完全不同
标量函数（返回单个值）可直接用于 LINQ 查询任意位置；表值函数（返回结果集）不能用 [DbFunction]，必须走 FromSqlRaw 或 FromSqlInterpolated：
- 标量示例：
ctx.Orders.Where(o => MyDbFunctions.CalculateScore(o.Amount, o.Rating) > 80)→ 生成WHERE dbo.CalculateScore([Amount], [Rating]) > 80 - TVF 示例：
ctx.Products.FromSqlRaw("SELECT * FROM dbo.GetProductsByCategory({0})", categoryId)，并配合只读实体类接收结果 - 注意 TVF 不支持 LINQ 组合（如后续
.Where()会被拉到客户端），需在 SQL 层完成过滤
跨数据库适配要注意函数名和参数顺序
同一个逻辑函数，在 SQL Server、PostgreSQL、SQLite 中名称或参数可能不同（比如距离计算、字符串截取）：
- 避免硬编码函数名；可通过条件编译或运行时判断数据库提供程序类型来动态注册
- SQLite 的
substr(str, start, len)在 EF Core 中需用EF.Functions.Substr(...)，不是自定义函数映射 - MySQL 用户需确认 Pomelo 提供程序是否支持
HasDbFunction（EF Core 7+ 基本支持，但部分旧版需升级）
基本上就这些。没注册 HasDbFunction 是最常见失败原因，其他问题多出在类型不匹配或函数不存在于目标库中。
