FreeSQL中字符串Contains函数参数含百分号的PostgreSQL生成SQL问题解析

在使用FreeSQL进行数据库操作时，开发人员可能会遇到一个有趣的字符串匹配问题：当使用Contains方法并传入包含百分号(%)的参数时，生成的SQL语句会出现参数位置错误的情况。本文将深入分析这个问题及其解决方案。

问题现象

在FreeSQL中，当我们使用类似a.Contains('b%')这样的表达式时，期望生成的SQL应该是strpos(a, 'b%') > 0，表示在字段a中查找包含"b%"字符串的位置。然而实际生成的SQL却是strpos('b%', a) > 0，这完全颠倒了参数的位置。

问题分析

这个问题主要出现在PostgreSQL数据库中，因为PostgreSQL使用strpos函数来实现字符串包含检查。strpos函数的正确语法应该是strpos(源字符串, 要查找的子字符串)，而FreeSQL错误地生成了参数位置相反的SQL。

这种错误会导致查询结果完全不符合预期，因为：

1. 逻辑上变成了在固定字符串"b%"中查找字段a的值
2. 完全违背了Contains方法的设计初衷

解决方案

FreeSQL团队在v3.2.830版本中修复了这个问题。对于暂时无法升级的用户，可以采用以下临时解决方案：

1. 使用原生SQL写法绕过：

.Where($"DeviceName like '%b%%'")

注意这里需要对百分号进行转义，第一个和第三个%是SQL的模糊匹配通配符，中间的%是实际要查找的字符。

2. 对于简单的包含查询，也可以考虑使用StartsWith或EndsWith方法替代。

最佳实践

在使用ORM进行字符串操作时，建议：

1. 明确了解各种字符串方法在不同数据库中的实现方式
2. 对于包含特殊字符(如%)的查询，要特别注意生成的SQL是否正确
3. 定期更新ORM版本以获取最新的bug修复
4. 对于复杂的字符串操作，考虑使用原生SQL以确保准确性

这个问题提醒我们，在使用ORM的高级功能时，仍需关注生成的SQL语句是否符合预期，特别是在处理特殊字符时更应谨慎。