Spring Data MongoDB：@ReadOnlyProperty字段更新时被删除的问题求助

Spring Data MongoDB的save()方法默认会替换整个文档。当你给字段标记@ReadOnlyProperty后，该字段在序列化（写入数据库）时会被Spring Data忽略，因此执行save()时，生成的待写入文档中不包含key2字段，替换操作会直接删除数据库中原有文档的key2字段，这就是问题的根源。@Version注解用于乐观锁控制，和字段被删除的问题无关，所以添加后无法解决问题。

以下是几种可行的解决方案，按推荐优先级排序：

方案1：使用MongoTemplate执行局部更新（推荐） #

避免使用save()的全文档替换，改用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.springframework.data.mongodb.core.query.Update;
import org.springframework.stereotype.Service;

@Service
public class SimpleClassService {

    private final MongoTemplate mongoTemplate;

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

    public void updateKey1(String id, String newKey1) {
        // 构建查询条件，定位目标文档
        Query query = Query.query(Criteria.where("_id").is(id));
        // 只更新需要修改的key1字段
        Update update = Update.update("key1", newKey1);
        // 执行更新操作
        mongoTemplate.updateFirst(query, update, SimpleClass.class);
    }
}

方案2：自定义Repository方法实现局部更新 #

扩展你的Repository接口，添加自定义的更新方法，通过@Query和@Update注解执行仅更新指定字段的操作：

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

public interface SimpleClassRepository extends MongoRepository<SimpleClass, String> {

    // 根据ID更新key1字段，不影响其他字段
    @Query("{ '_id' : ?0 }")
    @Update("{ '$set' : { 'key1' : ?1 } }")
    void updateKey1ById(String id, String key1);
}

调用该方法时，MongoDB会执行$set操作仅更新key1，key2字段会被完整保留。

方案3：全局配置更新策略，让save()执行局部更新 #

如果坚持要使用save()方法，可以通过配置让Spring Data MongoDB默认执行局部更新（仅变更字段），而非全文档替换。创建Mongo配置类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.MongoClientFactoryBean;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.convert.MappingMongoConverter;
import org.springframework.data.mongodb.core.convert.UpdateStrategy;

@Configuration
public class MongoConfiguration {

    @Bean
    public MongoClientFactoryBean mongoClient() {
        MongoClientFactoryBean factoryBean = new MongoClientFactoryBean();
        factoryBean.setHost("localhost"); // 替换为你的MongoDB地址
        factoryBean.setPort(27017);
        return factoryBean;
    }

    @Bean
    public MongoTemplate mongoTemplate() throws Exception {
        MongoTemplate mongoTemplate = new MongoTemplate(mongoClient().getObject(), "your-database-name");
        MappingMongoConverter converter = (MappingMongoConverter) mongoTemplate.getConverter();
        // 设置更新策略为仅更新变更的字段
        converter.setUpdateStrategy(UpdateStrategy.UPDATE);
        converter.afterPropertiesSet();
        return mongoTemplate;
    }
}

这个配置是全局生效的，所有实体的save()操作都会变为局部更新。此时@ReadOnlyProperty标记的key2字段不会被纳入更新操作，数据库中的key2值会被保留。

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