LLM项目中的SQL查询语法错误问题分析

在LLM项目中，当用户尝试同时使用-q（查询）和-m（模型）参数过滤日志时，系统会抛出一个SQL语法错误。这个问题源于SQL查询语句构建逻辑中的一个缺陷。

问题现象

用户执行类似以下命令时：

llm logs -q 'flourish' -m haiku

系统会抛出sqlite3.OperationalError: near "where": syntax error错误。通过调试发现，生成的SQL语句中存在语法问题。

根本原因

生成的SQL语句中出现了两个连续的WHERE子句：

where responses_fts match :query where responses.model = :model

这是不合法的SQL语法。在SQL中，WHERE子句只能出现一次，多个条件应该使用AND或OR连接。

技术分析

在SQLite的全文搜索(FT5)功能中，match操作符用于全文搜索查询。正确的语法应该是将全文搜索条件和其他过滤条件合并到一个WHERE子句中，例如：

where responses_fts match :query AND responses.model = :model

解决方案

修复方案应该修改SQL查询构建逻辑，确保：

1. 当同时存在全文搜索条件和其他过滤条件时，将它们合并到一个WHERE子句中
2. 使用适当的逻辑运算符(通常是AND)连接不同条件
3. 保持查询参数的正确绑定

影响范围

这个问题会影响所有尝试同时使用全文搜索和模型过滤功能的用户。单独使用其中任一功能则不受影响。

最佳实践

在构建动态SQL查询时，特别是组合多个过滤条件时，应该：

1. 使用参数化查询防止SQL注入
2. 确保WHERE子句的正确结构
3. 考虑使用查询构建器库来减少手动拼接SQL字符串的错误风险
4. 为复杂查询编写全面的单元测试

这个问题虽然看似简单，但它提醒我们在构建动态SQL时需要格外小心语法结构的正确性。