Spring Boot MongoDB按ID和Tenant查询返回404问题排查

问题根源 #

你在自定义@Query中手动使用ObjectId(?0)的写法不符合Spring Data MongoDB的查询语法规范，导致生成的查询无法正确匹配MongoDB中存储的ObjectId类型_id字段。

具体分析 #

1. 你的BaseModel里id字段标注了@MongoId(FieldType.OBJECT_ID)，且GenericDataSet继承自TenantBaseModel<String>，这意味着Java代码用String类型存储ID，但MongoDB实际存储的是ObjectId类型。Spring Data MongoDB默认会自动处理String类型ID参数与MongoDB ObjectId的转换逻辑。
2. 你写的@Query(value = "{ '_id' : ObjectId(?0), 'tenant' : ?1 }")是错误的：Spring Data MongoDB解析该语句时，会直接将?0替换为传入的字符串参数，并不会执行ObjectId()函数调用，最终生成的查询结构无法匹配数据库中的ObjectId类型字段。
3. MongoDB Atlas控制台支持直接使用ObjectId('xxx')构造查询条件，但这种函数调用写法并不适用于Spring Data MongoDB的@Query注解。

解决方案 #

方案一：简化@Query语句（推荐）

去掉ObjectId()包装，让Spring自动处理ID类型转换：

@Query(value = "{ '_id' : ?0, 'tenant' : ?1 }")
Optional<M> findById(String id, String tenant);

方案二：使用MongoTemplate构建查询

如果需要更灵活的查询逻辑，可以直接用MongoTemplate手动构造查询条件：

import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.query.Criteria;
import org.springframework.data.mongodb.core.query.Query;
import org.bson.types.ObjectId;

// 在你的Repository或Service中注入MongoTemplate
private final MongoTemplate mongoTemplate;

public Optional<GenericDataSet> findById(String id, String tenant) {
    Query query = new Query()
            .addCriteria(Criteria.where("_id").is(new ObjectId(id)))
            .addCriteria(Criteria.where("tenant").is(tenant));
    return Optional.ofNullable(mongoTemplate.findOne(query, GenericDataSet.class));
}

内容的提问来源于stack exchange，提问作者ethan