Eclipse Store结合Micronaut与Record时更新存储不生效问题

API 探路者

2026-6-24

Eclipse Store更新不生效问题排查与修复

核心问题

你的代码生成了新的Country实例，但未将新实例替换根对象Map中的旧条目。Eclipse Store基于对象引用追踪状态变化，根对象的country Map仍保留旧的Country引用，导致存储无法感知更新，GET请求自然返回旧值。

另外，@StoreReturn注解仅会存储返回的新对象，不会自动更新根对象内的引用，必须手动更新根对象的集合状态。

修复步骤

修改CountryRepository的patch方法，生成新Country后将其放回根对象的Map，并触发存储操作：

@Override
public Optional<CountryResponse> patch(UUID id, CountryRequest request) {
    Root root = rootProvider.root();
    Country country = root.getCountry().get(id);
    if (country == null)
        throw new RuntimeException(Constants.NO_Record_Found);
    
    var updatedCountry = updateCountry(country, request);
    // 关键操作：将新实例替换Map中的旧条目
    root.getCountry().put(id, updatedCountry);
    // 手动触发根对象存储，确保状态被持久化
    rootProvider.storeRoot();
    
    return Optional.of(this.countryToResponseMapper.apply(updatedCountry));
}

补充说明

Record不可变性适配：Country是不可变Record类型，无法修改现有实例属性，只能创建新实例，这部分逻辑是正确的，但必须确保新实例被同步到根对象的集合中。
Eclipse Store状态追踪规则：Store仅追踪根对象及其引用链的变化，集合内容更新（如Map条目替换）必须让Store感知——要么手动调用storeRoot()，要么将修改逻辑放在@Store注解的方法内。
@StoreReturn的局限性：该注解仅负责存储方法返回的对象，不会自动更新调用方的引用关系，因此必须手动维护根集合的引用更新。