SpringBoot MongoDB如何在嵌套对象中实现版本与审计信息自动填充

结论先行 #

该需求可实现。Spring Data MongoDB默认的审计、@Version版本控制机制仅作用于标注了@Document的根实体，你遇到的嵌套对象字段不自动填充是框架的默认行为，可通过扩展框架的写入前回调能力实现嵌套对象的字段自动填充。

具体实现步骤 #

1. 审计字段与版本号自动填充 #

通过实现Spring Data MongoDB提供的BeforeConvertCallback接口，在实体写入数据库前遍历处理嵌套对象的字段，手动填充审计信息和版本号：

@Component
public class NestedEntityAuditCallback implements BeforeConvertCallback<Object> {

    @Override
    public Object onBeforeConvert(Object entity, String collection) {
        // 处理EmployeeModelDTO的嵌套GroupDTO字段
        if (entity instanceof EmployeeModelDTO employeeModel) {
            GroupDTO group = employeeModel.getGroupDTO();
            if (group == null) {
                return entity;
            }
            LocalDateTime currentTime = LocalDateTime.now();
            // 新增场景：填充创建时间、初始版本号
            if (group.getId() == null || group.getCreatedDateTime() == null) {
                group.setCreatedDateTime(currentTime);
                group.setSchema_version(1);
            }
            // 全量写入场景：更新修改时间、自增版本号
            group.setUpdatedDateTime(currentTime);
            group.setSchema_version(group.getSchema_version() + 1);
        }
        // 如果有多个需要处理的嵌套实体类型，可在此处扩展判断逻辑，也可通过反射通用扫描所有嵌套对象的审计注解
        return entity;
    }
}

2. 嵌套对象版本控制额外说明 #

框架默认的乐观锁校验逻辑只会校验根实体的@Version字段，嵌套对象的版本号不会被自动校验，如果你需要嵌套对象的乐观锁能力，需要在业务逻辑中自行实现校验规则：

• 写入前先查询现有存储的嵌套对象版本号
• 对比传入的版本号与库中版本号，不一致时抛出乐观锁异常即可

替代方案 #

如果你的嵌套对象需要完整的原生审计、版本控制能力，也可以将GroupDTO调整为独立的根实体（添加@Document注解），在EmployeeModelDTO中通过@DBRef注解关联GroupDTO，此时框架默认的审计和版本控制逻辑会对GroupDTO自动生效，该方案的缺点是会额外增加关联查询的开销，适合嵌套对象需要独立维护的业务场景。

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