MongoCK ChangeUnit无法自动注入Spring Bean及数据插入报错排查

核心问题分析 #

你的三种实现方式失败，本质是Mongock的ChangeUnit生命周期与Spring Bean生命周期不同步，且默认情况下Mongock不会自动识别部分Spring注解（如@PostConstruct、@Value），也需要显式配置让Mongock能访问Spring管理的Bean。

正确实现方案 #

1. 确保Mongock与Spring集成配置正确

首先确认项目中引入了适配Spring的Mongock依赖（如mongock-springboot-v3、mongock-driver-mongodb-springdata-v3），并在启动类添加@EnableMongock注解，开启Spring上下文集成。

2. 用Mongock生命周期注解替代Spring原生注解

放弃@PostConstruct，改用Mongock提供的@BeforeExecution注解——它会在@Execution方法执行前触发，此时依赖已完成注入，适合初始化数据。

3. 构造注入的正确姿势

构造注入失败是因为Mongock未找到对应的Spring Bean，需确保依赖Bean已被Spring管理（如加@Component），且Mongock能扫描到这些Bean。示例代码：

@ChangeUnit(id = "form-layout-initializer", order = "1")
public class FormLayoutChangeUnit {
    private final MongoDatabase mongoDatabase;
    private final ResourceLoader resourceLoader;
    private final ObjectMapper objectMapper;
    private List<FormLayout> formLayouts;

    // 构造注入Spring管理的Bean，Mongock会自动识别
    public FormLayoutChangeUnit(MongoDatabase mongoDatabase,
                                ResourceLoader resourceLoader,
                                ObjectMapper objectMapper) {
        this.mongoDatabase = mongoDatabase;
        this.resourceLoader = resourceLoader;
        this.objectMapper = objectMapper;
    }

    // 用@BeforeExecution替代@PostConstruct，在变更执行前初始化数据
    @BeforeExecution
    public void loadFormLayouts() throws IOException {
        Resource resource = resourceLoader.getResource("classpath:form_layouts.json");
        formLayouts = objectMapper.readValue(
            resource.getInputStream(),
            new TypeReference<List<FormLayout>>() {}
        );
    }

    @Execution
    public void execute(ClientSession clientSession) {
        if (formLayouts == null || formLayouts.isEmpty()) {
            throw new IllegalArgumentException("formLayouts can not be null or empty");
        }
        mongoDatabase.getCollection("form_layouts", FormLayout.class)
            .insertMany(clientSession, formLayouts)
            .subscribe(new SingleSubscriber<>());
    }
}

4. 解决配置注入（@Value）的问题

Mongock默认不支持@Value，需通过Spring的Environment或@ConfigurationProperties类获取配置：

// 方式1：注入Environment
@ChangeUnit(id = "config-change-unit", order = "2")
public class ConfigChangeUnit {
    private final Environment env;

    public ConfigChangeUnit(Environment env) {
        this.env = env;
    }

    @BeforeExecution
    public void init() {
        String layoutPath = env.getProperty("app.form.layout.path", "classpath:default_layouts.json");
        // 加载数据逻辑
    }

    @Execution
    public void execute() {
        // 执行变更
    }
}

// 方式2：使用@ConfigurationProperties
@ConfigurationProperties(prefix = "app.form")
@Component
public class FormProperties {
    private String layoutPath;
    // getter/setter
}

// 在ChangeUnit中注入
public ConfigChangeUnit(FormProperties formProperties) {
    this.formProperties = formProperties;
}

原方案失败原因解析 #

1. @Autowired+@PostConstruct：Mongock处理ChangeUnit的时机早于Spring的@PostConstruct执行，导致初始化逻辑未触发，formLayouts为空。
2. 构造注入失败：依赖Bean未被注册到Mongock的依赖上下文，需确保Bean被Spring管理且Mongock扫描范围覆盖该Bean。
3. @Execution中@Value为空：Mongock不支持直接解析Spring的@Value注解，需通过Environment或配置类间接获取。

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