如何使用Spring Boot更新MongoDB中的嵌套数组数据？

1. 使用MongoTemplate实现更新 #

这是Spring Boot操作MongoDB最灵活的方式，适配复杂更新场景：

核心逻辑 #

• 匹配_id为2的目标文档
• 用MongoDB的$push操作符向categoryPackages数组追加新元素
• 用$set操作符新增_class字段（字段不存在时自动创建）

代码实现 #

首先确保实体类与数据库结构对应（简化版）：

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
import java.util.List;

@Document(collection = "categories") // 替换为你的集合名称
public class Categories {
    @Id
    private Long id;
    private String name;
    private List<CategoryPackage> categoryPackages;
    private String _class;

    // 省略getter、setter、构造方法
}

// 嵌套的子文档实体
class CategoryPackage {
    private Integer _id;
    private String name;
    private String coverPage;

    // 省略getter、setter、构造方法
}

在Service层编写更新逻辑：

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.springframework.data.mongodb.core.query.Update;
import org.springframework.stereotype.Service;

@Service
public class CategoryService {
    private final MongoTemplate mongoTemplate;

    public CategoryService(MongoTemplate mongoTemplate) {
        this.mongoTemplate = mongoTemplate;
    }

    public void updateTargetCategory() {
        // 构造查询条件：定位_id=2的文档
        Query query = new Query(Criteria.where("id").is(2L));

        // 构造更新操作
        Update update = new Update();
        // 准备要追加的数组元素
        CategoryPackage newChennaiPackage = new CategoryPackage();
        newChennaiPackage.set_id(0);
        newChennaiPackage.setName("Chennai");
        newChennaiPackage.setCoverPage("https://www.tourmyindia.com/images/kerala-tour-fd6.jpg");
        // 追加到数组
        update.push("categoryPackages", newChennaiPackage);
        // 新增_class字段
        update.set("_class", "com.traveldiaries.categories.Categories");

        // 执行更新：仅修改匹配到的第一个文档
        mongoTemplate.updateFirst(query, update, Categories.class);
    }
}

2. 使用MongoRepository自定义查询实现更新 #

如果偏好Repository风格的代码，可以通过注解直接定义更新逻辑：

定义Repository接口 #

import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.data.mongodb.repository.Query;
import org.springframework.data.mongodb.repository.Update;

public interface CategoryRepository extends MongoRepository<Categories, Long> {
    @Query("{ '_id' : ?0 }")
    @Update("{ '$push' : { 'categoryPackages' : ?1 }, '$set' : { '_class' : ?2 } }")
    void updateCategoryById(Long id, CategoryPackage newPackage, String className);
}

调用更新方法 #

在Service中直接调用Repository方法：

@Service
public class CategoryService {
    private final CategoryRepository categoryRepository;

    public CategoryService(CategoryRepository categoryRepository) {
        this.categoryRepository = categoryRepository;
    }

    public void updateTargetCategory() {
        CategoryPackage newChennaiPackage = new CategoryPackage();
        newChennaiPackage.set_id(0);
        newChennaiPackage.setName("Chennai");
        newChennaiPackage.setCoverPage("https://www.tourmyindia.com/images/kerala-tour-fd6.jpg");
        
        categoryRepository.updateCategoryById(2L, newChennaiPackage, "com.traveldiaries.categories.Categories");
    }
}

关键注意点 #

• $push只会向数组末尾追加元素，不会修改原有数组内容，是MongoDB数组追加的标准操作符
• $set用于设置字段值，若字段不存在则自动新增，不会影响其他已有字段
• 两种方式默认仅更新匹配到的第一个文档，若需批量更新可替换为updateMulti（MongoTemplate）或调整Repository逻辑

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