Spring Data MongoDB中Criteria.is()与其他条件组合时的查询构造问题

问题背景

在使用Spring Data MongoDB进行查询构建时，开发人员发现当使用Criteria.is()方法与其他条件（如类型检查）组合时，生成的MongoDB查询文档存在格式问题。这个问题会影响查询的正确执行，需要开发者特别注意。

问题现象

当开发者尝试构建如下查询条件时：

Criteria.where("name")
    .is(123)
    .type(JsonSchemaObject.Type.INT_64)

生成的MongoDB查询文档为：

{"name": 123, "$type": ["long"]}

这种格式实际上是无效的MongoDB查询语法。正确的做法应该是将多个条件组合成一个子文档。

问题分析

深入分析这个问题，我们发现：

1. is()方法的特殊性：is()方法在Spring Data MongoDB中被设计为一种简写形式，当单独使用时，它会生成直接的字段-值对（如{"name": 123}），而不是使用$eq操作符。

2. 条件组合的冲突：当is()与其他条件（如type()）组合时，系统没有正确处理这种混合情况，导致生成了格式错误的查询文档。

3. 对比其他操作符：有趣的是，使用in()方法代替is()时，生成的查询文档是正确的：

Criteria.where("name")
    .in(123)
    .type(JsonSchemaObject.Type.INT_64)

这会生成：

{"name": {"$in": [123], "$type": ["long"]}}

解决方案

针对这个问题，Spring Data MongoDB团队已经修复了这个问题。修复后的行为是：

当is()与其他条件组合时，系统会将is()转换为使用$eq操作符，并将所有条件组合成一个子文档。例如：

Criteria.where("name")
    .is(123)
    .type(JsonSchemaObject.Type.INT_64)

现在会正确生成：

{"name": {"$eq": 123, "$type": ["long"]}}

开发者建议

1. 版本升级：建议开发者升级到包含此修复的Spring Data MongoDB版本。

2. 临时解决方案：如果暂时无法升级，可以显式使用$eq操作符代替is()：

Criteria.where("name")
    .andOperator(
        Criteria.where("").is(123),
        Criteria.where("").type(JsonSchemaObject.Type.INT_64)
    )

3. 查询验证：在构建复杂查询时，建议使用toString()方法检查生成的查询文档格式是否正确。

总结

这个问题揭示了Spring Data MongoDB查询构建器在处理is()方法与其他条件组合时的特殊行为。理解这一点对于构建正确的MongoDB查询非常重要。开发者应当注意查询条件的组合方式，并在遇到问题时检查生成的查询文档是否符合MongoDB的语法规范。