V0.2 异步运行时
本文档用于收口 V0.2 阶段。V0.2 的目标是把异步任务、调度、事件、存储和日志链路整理成更稳定的运行时底座,让业务模块可以在不引入外部重型中间件的情况下完成常规异步处理。
版本号:0.2.0
发布状态:已发布。
GitHub Release:https://github.com/spring-open/spring-open/releases/tag/v0.2.0
发布目标
V0.2 应满足:
- Queue、Scheduler、Event、Storage 能作为稳定基础能力使用。
- 异步任务、调度任务、事件监听、文件存储和运行日志能串联 traceId。
- 不依赖外部 MQ 或调度中心,也能完成本地开发和轻量部署。
- 文档能说明每个异步运行时模块怎么配置、怎么使用、怎么运维。
- 已完成能力保持默认可用,未完成的高阶能力不阻塞发布。
当前状态
截至 2026-05-24,V0.2 已具备较多基础能力:
| 能力 | 状态 | 说明 |
|---|---|---|
| Queue | 基本完成 | 已支持 sync、memory、redis、database driver、QueueJob、自动 worker、失败任务和后台运维入口 |
| Scheduler | 基本完成 | 已支持 db-scheduler、Redis、memory driver、暂停/恢复、手动触发、执行日志、失败重试和后台运维入口 |
| Event | 基本完成 | 已支持同步/异步事件、Spring 事件适配、事务后监听样板和 Queue/Scheduler 协作样板 |
| Storage | 基本完成 | 已支持 public/local/memory disk、S3 兼容、x-file-storage 适配的主流对象存储和私有签名访问 |
| Logging | 基本完成 | 已新增 spring-open-starter-logging 第一阶段,支持轻量请求日志、query 脱敏、慢请求标记、异常类型标记和 TraceId 兜底;登录日志、操作日志、任务日志等由 IAM、Audit、Scheduler、Notification 等 owning core 模块分别承载 |
V0.2 必须包含
| 能力 | 模块 | 验收标准 |
|---|---|---|
| Queue | spring-open-starter-queue | 队列投递、自动 worker、失败重试、失败任务后台运维可用 |
| Scheduler | spring-open-starter-scheduler | 持久化任务、Redis 轻量任务、执行日志、失败重试和后台运维可用 |
| Event | spring-open-starter-event | 同步/异步事件、事务事件样板、Queue/Scheduler 协作样板可用 |
| Storage | spring-open-starter-storage | public/local disk、对象存储适配、文件元数据、私有签名访问可用 |
| Logging | spring-open-starter-logging、spring-open-starter-webmvc、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit、相关业务 starter | 请求日志、TraceId、运行日志、操作日志、登录日志、任务日志、发送日志和调用日志边界清晰 |
| Docs | docs/ | Queue、Scheduler、Event、Storage、Logging 相关文档可读、可查、可复制 |
V0.2 不阻塞项
以下能力可以继续推进,但不作为 V0.2 发布阻塞项:
- 更多 Queue driver,例如 RabbitMQ、Kafka、RocketMQ。
- 更复杂的 Scheduler driver,例如 XXL-Job、Quartz、ElasticJob。
- Storage 分片上传、缩略图、更多云厂商私有特性。
- Observability、Tracing、Metrics 的完整生产级体系。
- Web3、Payment、Open Platform 的更深生态能力。
发布前检查清单
- [x] 工作区没有无关改动。
- [x]
spring-open-application测试通过。 - [x] Queue / Scheduler / Event / Storage / Logging 相关定向测试通过。
- [x] 文档站点构建通过。
- [x]
git diff --check通过。 - [x]
docs/zh-CN/queue.md、scheduler.md、event.md、storage.md、logging.md、testing.md与当前代码一致。 - [x] Logging starter 第一阶段已完成:轻量请求日志、敏感 query 脱敏、慢请求标记、异常类型标记和 TraceId 兜底已具备。
- [x]
.ai/progress.md、.ai/todo.md和.ai/plan.md已记录最新状态。
V0.2 之后
V0.2 发布后,建议继续推进:
- V0.3:业务基础设施,重点是 Mail、SMS、Notification、WebSocket、Rate Limit。
- V0.4:生态能力,重点是 Payment、Web3、Open Platform、OAuth、Observability。
- V1.0:稳定 API、兼容矩阵、Maven 发布、完整文档、完整样板和变更日志。