ServiceStack AutoQuery自定义规约在PostgreSQL中参数传递异常问题

你遇到的核心问题是自定义规约的SQL模板写法不符合PostgreSQL的参数化要求，导致ORM无法正确识别并传递参数。我来拆解下原因和具体解决方案：

问题根源 #

你最初的规约模板里，把{Value}包裹在了单引号的字符串中：

autoQuery.ImplicitConventions.Add("%WithinLastDays", "{Field} > NOW() - INTERVAL '{Value} days'");

这种写法会让ORM把整个'{Value} days'当成固定字符串常量，而非需要参数化的表达式。所以生成的SQL才会出现':0 days'——这里的:0只是个形式上的占位符，并没有实际绑定你传入的参数值。

内置规约能正常工作，是因为它们针对不同数据库（包括PostgreSQL）做了适配，用了正确的参数化语法。

解决方案 #

1. 修复%WithinLastDays规约 #

针对PostgreSQL，有两种可靠的参数化写法：

方法一：使用make_interval函数（推荐，可读性更强）

PostgreSQL的make_interval函数支持直接传入天数参数，能让{Value}被正确识别为数值参数：

autoQuery.ImplicitConventions.Add("%WithinLastDays", "{Field} > NOW() - make_interval(days => {Value})");

生成的SQL会变成：

WHERE "TABLE"."FIELD" > NOW() - make_interval(days => @p0)

这里的@p0会正确绑定你传入的天数参数。

方法二：用INTERVAL乘以数值

也可以通过INTERVAL '1 day'乘以天数参数实现参数化：

autoQuery.ImplicitConventions.Add("%WithinLastDays", "{Field} > NOW() - INTERVAL '1 day' * {Value}");

生成的SQL类似：

WHERE "TABLE"."FIELD" > NOW() - INTERVAL '1 day' * @p0

2. 修复EndsWithConvention规约 #

同样要避免把{Value}放在单引号里，改用字符串拼接方式：

方法一：使用CONCAT函数

autoQuery.ImplicitConventions.Add("%EndsWith", "{Field} LIKE CONCAT('%', {Value})");

方法二：使用PostgreSQL字符串连接操作符||

autoQuery.ImplicitConventions.Add("%EndsWith", "{Field} LIKE '%' || {Value}");

这两种写法都会让{Value}作为参数被正确传递，生成的SQL为：

WHERE "TABLE"."FIELD" LIKE '%' || @p0

验证建议 #

修改后可以开启SQL日志，查看生成的语句是否正确绑定了参数占位符（比如@p0），确认参数值已经传递到PostgreSQL引擎。

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