如何在Spring MongoDB的@Document注解中访问VM参数

问题核心 #

能否仅通过@Document注解的SpEL表达式直接访问Java系统属性或环境变量来动态指定MongoDB集合名称？为什么直接用#{systemProperties['MY_MONGO_COLLECTION']}会报错？

报错原因 #

你遇到的EL1007E: Property or field 'systemProperties' cannot be found on null错误，是因为Spring Data MongoDB在解析@Document注解的SpEL时，使用的是简化版的EvaluationContext——此时Spring上下文尚未完全初始化，systemProperties这类根对象并未被注入到表达式上下文中，因此无法直接访问。

可行解决方案 #

方案1：直接通过Java系统类获取系统属性/环境变量 #

利用SpEL的T()语法调用System类的静态方法，绕过上下文依赖，直接读取系统属性或环境变量：

读取Java系统属性（启动参数-Dxxx）

@Document(collection = "#{T(System).getProperty('MY_MONGO_COLLECTION', 'default_my_collection')}")
@AllArgsConstructor
@NoArgsConstructor
@JsonInclude(JsonInclude.Include.NON_EMPTY)
@Data
public class MyCollection {
    @Id
    String id;
    // 其他字段
}

• T(System)表示调用java.lang.System类
• getProperty的第二个参数是默认值，避免未传参数时抛出异常

读取环境变量

如果要读取操作系统环境变量，替换为getenv方法：

@Document(collection = "#{T(System).getenv('MY_MONGO_COLLECTION') ?: 'default_my_collection'}")

• ?:是SpEL的空值运算符，当环境变量不存在时使用默认值

方案2：自定义集合名称提供器（复杂场景） #

如果需要依赖Spring环境变量（比如application.properties中的配置）或针对多实体做动态逻辑，推荐实现MongoCollectionNameProvider接口：

1. 实现自定义Provider类：

@Component
public class DynamicCollectionProvider implements MongoCollectionNameProvider {

    @Value("${my.mongo.collection:default_my_collection}")
    private String targetCollection;

    @Override
    public String getCollectionName(MongoPersistentEntity<?> entity) {
        // 针对指定实体返回动态名称，其他实体沿用默认配置
        if (entity.getType().equals(MyCollection.class)) {
            return targetCollection;
        }
        return entity.getCollection();
    }
}

2. 在Mongo配置类中注册该Provider：

@Configuration
public class MongoConfig {

    @Bean
    public MappingMongoConverter mappingMongoConverter(MongoDatabaseFactory dbFactory,
                                                     MongoMappingContext mappingContext,
                                                     DynamicCollectionProvider collectionProvider) {
        MappingMongoConverter converter = new MappingMongoConverter(new DefaultDbRefResolver(dbFactory), mappingContext);
        converter.setCollectionNameProvider(collectionProvider);
        return converter;
    }
}

总结 #

• 简单场景（直接读取系统属性/环境变量）：优先使用T(System).getProperty()或T(System).getenv()的SpEL写法，无需额外配置
• 复杂场景（依赖Spring环境、多实体动态配置）：通过实现MongoCollectionNameProvider实现完全自定义的集合名称逻辑

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