Spring Data Cosmos中@Container注解如何传入布尔类型配置值

问题原因 #

@Container 注解的 autoScale 参数原生定义为 boolean 类型，仅支持直接传入 true/false 布尔常量。Spring Data Cosmos 的注解处理器当前仅对字符串类型的注解参数（比如 containerName）做了 ${} 占位符解析逻辑，未对布尔类型参数做占位符解析，因此直接传入字符串类型的占位符会触发类型不匹配报错。

解决方案 #

方案1：编程式动态初始化容器（推荐） #

在应用启动阶段读取配置属性，调用 Cosmos SDK API 手动配置容器参数，替代注解静态配置：

1. 首先编写配置类读取自定义配置：

@Configuration
@ConfigurationProperties(prefix = "dynamic.container")
public class ContainerConfig {
    private String name;
    private Boolean autoScale;
    private Integer ru = 400;
    // 省略getter、setter方法
}

2. 编写容器初始化逻辑，应用启动时自动创建/更新容器配置：

@Component
public class ContainerInitializer implements ApplicationRunner {
    @Autowired
    private CosmosAsyncClient cosmosAsyncClient;
    @Autowired
    private ContainerConfig containerConfig;
    @Value("${azure.cosmos.database}")
    private String databaseName;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        CosmosAsyncDatabase database = cosmosAsyncClient.getDatabase(databaseName);
        // 容器不存在则按配置创建，已存在会跳过创建逻辑
        database.createContainerIfNotExists(
            new ContainerProperties(containerConfig.getName(), "/你的分区键路径"),
            containerConfig.getRu(),
            containerConfig.getAutoScale()
        ).block();
    }
}

注意根据你使用的 Spring Data Cosmos 版本调整 API 入参顺序即可
3. 实体类保留原有容器名配置即可：

@Container(containerName = "${dynamic.container.name}", ru = "400")
public class FruitsContainer {
    // 类原有逻辑
}

方案2：自定义Bean后置处理器修改注解属性 #

如果不想调整原有注解配置的结构，可以自定义后置处理器，在 @Container 注解被解析前动态替换 autoScale 的值：

@Component
public class ContainerAnnotationPostProcessor implements BeanPostProcessor {
    @Value("${dynamic.container.autoScale:false}")
    private Boolean autoScaleConfig;

    @Override
    public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
        Container containerAnno = AnnotationUtils.findAnnotation(bean.getClass(), Container.class);
        if (containerAnno != null) {
            AnnotationAttributes annoAttrs = AnnotationAttributes.fromMap(AnnotationUtils.getAnnotationAttributes(containerAnno));
            if (annoAttrs != null) {
                annoAttrs.put("autoScale", autoScaleConfig);
            }
        }
        return bean;
    }
}

使用该方案需要手动调整后置处理器的优先级，确保其执行时机早于 Spring Data Cosmos 内置的 CosmosMappingContext 初始化逻辑。

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