17370845950

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