Electric SQL 中 WHERE 子句失效问题的排查与解决

在使用 Electric SQL 进行数据查询时，开发者可能会遇到 WHERE 子句似乎被忽略的情况。本文将通过一个实际案例，深入分析这类问题的成因和解决方法。

问题现象

开发者在 React 应用中使用 useShape 钩子查询特定 token 的交换记录，WHERE 条件包含对 token 地址和时间范围的筛选。尽管请求参数看起来正确，但返回结果却包含了表中的所有数据，WHERE 条件似乎没有生效。

问题分析

通过检查请求流程，发现问题的根源在于中间层的参数过滤。中间服务中有一个查询参数白名单机制，只允许特定的参数（如 live、table、handle 等）通过，而 where 参数不在这个白名单中，导致 WHERE 条件在到达 Electric SQL 服务前就被过滤掉了。

解决方案

1. 修改中间层白名单：将 where 参数添加到中间服务的允许列表中
2. 完整参数转发：更安全的做法是转发所有参数，除非有明确的安全考虑需要过滤特定参数
3. 参数验证：在中间层添加对 WHERE 条件的验证，确保 SQL 注入防护

最佳实践建议

1. 调试技巧：遇到类似问题时，应该检查整个请求链路，确认参数是否完整传递
2. 中间层设计：在设计 API 中间层时，应该明确文档说明哪些参数会被转发
3. 错误处理：考虑在中间层添加对缺失关键参数的检测和错误返回
4. SQL 安全：虽然解决了参数传递问题，但仍需注意防范 SQL 注入风险

总结

这个案例展示了分布式系统中常见的问题模式：一个看似简单的功能问题，实际可能是系统各层间协作的问题。开发者需要具备全链路调试的思维，特别是在涉及多层中间层和转发的场景中。通过这个问题的解决，我们不仅修复了当前的功能，也为系统未来的可维护性打下了更好的基础。