Spring Data Mongo的@TimeSeries注解对应依赖及Spring Boot适配问题

1. 注解所属依赖 #

@TimeSeries是spring-data-mongodb模块的专属功能注解，并非Spring框架自带的通用注解，最低支持版本为Spring Data MongoDB 3.3.0及以上。

2. Spring Boot版本适配说明 #

确实存在Spring Data模块先行发布功能、Spring Boot后续版本才完成集成适配的情况，对应适配规则如下：

• Spring Boot 2.6.x及更高版本：官方默认集成的spring-data-mongodb版本已≥3.3.0，直接引入spring-boot-starter-data-mongodb启动器依赖即可正常使用@TimeSeries注解，无需额外配置。
• Spring Boot 2.5.x及更低版本：默认集成的spring-data-mongodb版本低于3.3.0，因此无法找到该注解。此时可选择两种方案解决：
  • 方案一：将Spring Boot版本升级到2.6.x及以上稳定版，是兼容性最优的选择
  • 方案二：手动覆盖spring-data-mongodb依赖的版本到3.3.0及以上，但需注意手动跨版本升级依赖可能存在兼容性问题，需做好全量功能测试

手动指定依赖版本的Maven配置示例：

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-mongodb</artifactId>
    <version>3.4.17</version> <!-- 可替换为更高稳定版本 -->
</dependency>

额外注意事项 #

时间序列集合是MongoDB 5.0版本才新增的功能，即使依赖配置正确，若MongoDB服务端版本低于5.0，调用template.createCollection()创建集合时仍会抛出异常。

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