System.Data.SQLite注册非REGEXP名自定义函数报语法错误异常

云上老周

2026-8-28

问题根因

这个报错和UDF注册逻辑无关，是SQL语法认知偏差导致的，核心点如下：

REGEXP是SQLite语法层面原生预留的特殊二元中缀操作符，和LIKE、GLOB、MATCH属于同一类内置关键字，SQL解析器天然认可左操作数 REGEXP 右操作数的写法，解析阶段会自动将这种语法转换为对名为REGEXP的标量函数的调用，因此不会报语法错误。
你自定义的MyUdf属于普通用户自定义标量函数，不是SQLite内置的语法关键字，直接写Node.Labels MyUdf 'testvalue'完全不符合SQL语法规则，在SQL语句预编译（Prepare）阶段就会抛出语法错误，根本不会走到后续的函数查找、调用逻辑。
补充说明：你测试REGEXP能正常触发Invoke不代表UDF注册流程是规范的。System.Data.SQLite不会默认自动扫描带SQLiteFunction特性的类完成注册，部分版本会在类型被CLR加载时隐式注册带特性的函数，但这个行为不稳定，生产环境不能依赖。

修复方案

按以下两步调整即可正常使用自定义函数：

修正SQL语句中的UDF调用写法，普通自定义标量函数必须使用标准函数调用语法，参数放在括号内传入。对应你的测试方法，将SQL构造逻辑修改为：

// 注意参数顺序和你UDF的逻辑对应，这里假设第一个参数是字段值，第二个是待匹配的目标值
var commandText = $"select Node.* from Node where {funcName}(Node.Labels, 'testvalue') = 1";

提示：SQLite本身没有原生布尔类型，布尔判断对应整数值1（真）/0（假），显式写=1的判断可以避免隐式转换带来的兼容问题。

在程序启动、创建第一个SQLite连接之前，显式注册自定义函数，不要依赖隐式注册行为：

// 传入你定义的UDF类的类型即可完成全局注册，注册一次对所有连接生效
SQLiteFunction.RegisterFunction(typeof(FirstUdf));

如果不想手动编写注册代码，也可以在App.config/Web.config中添加如下配置，让System.Data.SQLite启动时自动扫描注册指定程序集内的UDF：

<configuration>
  <system.data>
    <DbProviderFactories>
      <remove invariant="System.Data.SQLite"/>
      <add name="SQLite Data Provider" invariant="System.Data.SQLite"
           description=".NET Framework Data Provider for SQLite"
           type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite"/>
    </DbProviderFactories>
    <sqliteFunctions>
      <add assembly="你的项目程序集名称" type="你的命名空间.FirstUdf"/>
    </sqliteFunctions>
  </system.data>
</configuration>

补充说明：如果要实现类似A 自定义操作符 B的中缀写法，System.Data.SQLite没有提供自定义SQL语法关键字的公开接口，只能通过修改SQLite内核源码重编译、或者自定义解析层预处理SQL的方式实现，普通业务场景直接使用标准函数调用语法即可。

内容的提问来源于stack exchange，提问作者Areb