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]) > 80TVF 示例：
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是最常见失败原因，其他问题多出在类型不匹配或函数不存在于目标库中。
