Spring Data MongoDB @Update注解如何传递arrayFilters参数

你的写法报错核心原因是：$arrayFilters是MongoDB更新请求中与更新文档平级的独立配置项，不属于更新文档内部的操作符。Spring Data MongoDB 3.4.x版本的@Update注解没有暴露arrayFilters的配置入口，解析注解内的字符串时只会将内容识别为更新操作符集合，不会提取其中混入的$arrayFilters字段转为独立更新配置，最终MongoDB驱动收到的请求中没有对应数组占位符的过滤规则，就会抛出「No array filter found for identifier 'c'」的错误。
另外你尝试的Repository写法里误用了$set操作符，会直接覆盖整个comments数组，而你原本基于MongoTemplate的实现用的是$addToSet追加元素，这个逻辑差异也需要修正。

方案1：自定义Repository片段实现（兼容Spring Data MongoDB 3.4.x，推荐） #

这个写法完全符合Spring Data Repository的分层设计，不需要把MongoTemplate逻辑散落在业务层，和原生声明式Repository的调用体验一致。

1. 首先定义自定义Repository接口：

public interface CustomProjectRepository {
    long addComment(String id, String cid, String lid, String sid, CommentEntity comment);
}

2. 编写实现类，注入MongoTemplate复用已经验证通过的更新逻辑：

public class CustomProjectRepositoryImpl implements CustomProjectRepository {

    private final MongoTemplate mongoTemplate;

    // 构造注入MongoTemplate
    public CustomProjectRepositoryImpl(MongoTemplate mongoTemplate) {
        this.mongoTemplate = mongoTemplate;
    }

    @Override
    public long addComment(String id, String cid, String lid, String sid, CommentEntity comment) {
        Query query = new Query();
        query.addCriteria(Criteria.where("_id").is(id));
        query.addCriteria(Criteria.where("chapters").elemMatch(
                Criteria.where("_id").is(cid).and("lessons").elemMatch(
                        Criteria.where("_id").is(lid).and("sections").elemMatch(
                                Criteria.where("_id").is(sid)
                        )
                )
        ));

        Update update = new Update();
        update.addToSet("chapters.$[c].lessons.$[l].sections.$[s].comments", comment);
        update.filterArray("c._id", cid);
        update.filterArray("l._id", lid);
        update.filterArray("s._id", sid);

        UpdateResult result = mongoTemplate.updateFirst(query, update, ProjectEntity.class);
        return result.getModifiedCount();
    }
}

3. 让原有ProjectRepository继承自定义接口：

@Repository
public interface ProjectRepository extends MongoRepository<ProjectEntity, String>, CustomProjectRepository {
    // 其他原有查询方法可直接保留，不受影响
}

业务层直接调用projectRepository.addComment(xxx)即可完成更新。

方案2：升级版本使用原生注解支持 #

从Spring Data MongoDB 4.1版本（对应Spring Boot 3.1+）开始，框架新增了@ArrayFilter注解配合@Update使用，可以直接在接口方法上声明数组过滤规则，不需要自定义实现：

@Repository
public interface ProjectRepository extends MongoRepository<ProjectEntity, String> {

    @Query("{ _id : ?0, chapters : {$elemMatch : {_id: ?1, lessons: {$elemMatch: {_id: ?2, 'sections._id': ?3}}}}}")
    @Update("{$addToSet : { 'chapters.$[c].lessons.$[l].sections.$[s].comments' : ?4 }}")
    @ArrayFilter("{ 'c._id': ?1 }")
    @ArrayFilter("{ 'l._id': ?2 }")
    @ArrayFilter("{ 's._id': ?3 }")
    long addComment(String id, String cid, String lid, String sid, CommentEntity comment);
}

注意不要把$arrayFilters混写在@Update的更新字符串中，每个数组过滤规则单独用一个@ArrayFilter声明即可，框架会自动将这些规则组装为独立配置传给MongoDB驱动。

该方案仅适用于Spring Boot 3.1.0及以上版本，Spring Boot 2.x对应的Spring Data MongoDB 3.x版本没有@ArrayFilter注解，只能使用方案1。

• 原手动实现使用$addToSet追加评论，该操作符会自动过滤完全重复的评论内容，如果业务允许重复提交相同评论，需替换为$push操作符
• 查询条件中的多层$elemMatch不要省略，否则嵌套层级过深时可能出现更新范围匹配错误
• 不要将$arrayFilters配置写入@Query注解，该注解仅负责解析文档匹配条件，不会处理更新选项参数

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