MikroORM中JSON字段查询在QB与Repository中的差异分析

MikroORM作为一款优秀的Node.js ORM框架，在处理JSON类型字段时提供了便捷的操作方式。然而在实际使用中，开发者可能会遇到查询构建器(QB)与Repository模式对JSON字段处理不一致的情况。

问题现象

当使用MikroORM操作SQLite数据库时，Repository模式的findAll方法可以正常查询JSON字段内容：

await repo.findAll({ where: { attrs: { test: { $eq: true } } });

但同样的查询条件在使用查询构建器时却会抛出异常：

await repo.qb()
  .where({ attrs: { test: { $eq: true } } })
  .getResultAndCount();

错误信息显示SQLite无法找到通过json_extract函数生成的列。

技术背景

MikroORM在处理JSON字段时，底层会转换为数据库特定的JSON处理函数。对于SQLite，使用的是json_extract函数。Repository模式与查询构建器虽然最终都会生成SQL查询，但在处理JSON字段时的实现路径有所不同。

深入分析

1. Repository模式：MikroORM的Repository对JSON字段有内置的特殊处理逻辑，能够正确地将对象形式的查询条件转换为数据库特定的JSON查询语法。

2. 查询构建器模式：直接使用查询构建器时，JSON字段的处理流程略有不同。在生成COUNT查询时，MikroORM内部对JSON字段的处理出现了问题，导致生成的SQL语句无法被SQLite正确解析。

3. 临时解决方案：测试表明单独使用getResult()方法可以正常工作，问题仅出现在getResultAndCount()组合方法中。这说明COUNT查询生成环节存在特定问题。

解决方案

MikroORM团队已经修复了这一问题。修复的核心在于调整了查询构建器在处理JSON字段时的SQL生成逻辑，确保无论是普通查询还是COUNT查询都能正确生成JSON提取表达式。

对于开发者而言，建议：

1. 升级到包含修复的MikroORM版本
2. 在需要同时获取结果和计数时，可以考虑暂时分两步操作：

   const results = await repo.qb().where(conditions).getResult();
   const total = await repo.qb().where(conditions).getCount();
   

最佳实践

1. 对于简单查询，优先使用Repository模式，它提供了更高级的抽象和更稳定的行为。
2. 对于复杂查询需要使用查询构建器时，注意测试JSON字段的查询功能。
3. 保持MikroORM版本更新，以获取最新的稳定性修复和功能改进。

通过理解MikroORM内部对JSON字段的处理机制，开发者可以更有效地利用这一强大功能，构建健壮的应用程序。