附录 E:迁移检查清单
Spring MVC + JDBC 到 WebFlux + R2DBC 迁移检查清单:技术栈替换对应表(JPA→R2DBC/HikariCP→ConnectionPool/RestTemplate→WebClient)、阻塞陷阱与 ThreadLocal 替代方案、读→写→网关迁移优先级、渐进式双写策略与验证 checklist。
tag
Spring MVC + JDBC 到 WebFlux + R2DBC 迁移检查清单:技术栈替换对应表(JPA→R2DBC/HikariCP→ConnectionPool/RestTemplate→WebClient)、阻塞陷阱与 ThreadLocal 替代方案、读→写→网关迁移优先级、渐进式双写策略与验证 checklist。
响应式弹性模式速查:重试 retryWhen 指数退避配置、熔断 CircuitBreakerOperator 参数、限流 RateLimiterOperator 令牌桶设置、降级 onErrorResume 模式、以及各模式的组合顺序与最佳实践。
Spring WebFlux 注解路由与函数式路由模板对照手册:Controller 方法签名与路径参数绑定、RouterFunctions 构建器 API、WebFilter Ordered 优先级顺序、SSE ServerSentEvent/文件上传 FilePart/全局异常处理代码片段速查。
R2DBC 与 Spring Data R2DBC 操作符速查:ConnectionFactory 创建、Statement 参数绑定与执行、Result map 与 rowsUpdated、DatabaseClient SQL 构建、以及 Repository 派生查询命名规则对照表。
Reactor Netty 常用配置速查表:HttpServer 端口绑定、LoopResources 线程池、ChannelOption 水位线与 keep-alive、HttpClient 连接池与超时、SSL 上下文、HTTP/2 开启,以及优雅关闭参数。
eventd v2 最终验收标准与交付:L1 功能验收(网关/API/数据/缓存/事件全 checklist)、L2 性能 QPS P99 基线对比、L3 运维 Docker K8s 部署、自动化测试覆盖率与代码审查、文档完整性、向卷三流处理引擎的衔接准备。
响应式系统故障排查完整手册:jstack 线程 dump 识别 EventLoop 阻塞与 boundedElastic 饱和、R2DBC Connection 与 Netty ByteBuf 连接泄漏定位、背压溢出 request(n) 诊断、io.netty.leakDetection.level=advanced 内存泄漏检测、错误日志速查表。
响应式系统上线前全面检查清单:EventLoop 线程池与 boundedElastic 配置、R2DBC/Redis/HTTP 连接池大小计算与超时层级设置、G1/ZGC JVM 参数、结构化日志级别与 Trace 采样率、密码 TLS CORS 安全核查与 Prometheus 告警基线。
响应式系统性能测试方法论完整指南:WebTestClient 并发请求压测与 QPS P99 延迟计算、JMH 微基准测试编写与火焰图热点分析、HDrHistogram 延迟分布分位数统计、连接池饱和与背压溢出诊断识别、性能回归基线对比与瓶颈定位。
Testcontainers 响应式集成测试:PostgreSQL 和 Redis 容器生命周期与动态端口映射、R2DBC JDBC 双连接动态配置、Flyway Schema 初始化与测试数据准备、容器复用与并行测试策略、CI 环境 Docker 配置。
reactor-test 的 StepVerifier 深度使用:期望链 assertNext/expectNext/expectComplete、虚拟时间调度器 VirtualTimeScheduler、背压请求量验证、错误信号断言,以及响应式操作符行为测试。
eventd v2 全链路端到端集成:从 Reactor Netty 网关到 WebFlux API 层,再到 R2DBC 数据访问与 Caffeine/Redis 缓存,贯穿 Micrometer 指标、分布式追踪与 Saga 事务补偿,附完整模块结构与可运行验收清单。
响应式 Saga 分布式事务模式完整指南:编排式与协同式两种实现方式深度对比、事务补偿操作幂等设计原则与有限重试策略、Saga 状态机持久化日志与故障恢复机制、响应式链逆序补偿回滚与并发陷阱防范、与 R2DBC 事务和事件总线的整合实践。
响应式事件驱动集成架构:ApplicationEventPublisher Reactor 适配与 @EventListener、自定义 Sinks.Many 响应式事件总线、领域事件与集成事件边界、事件网关转换模式、JSON 事件序列化与版本兼容策略。
响应式系统限流策略全面实践:令牌桶与漏桶算法原理对比与适用场景、Resilience4j RateLimiterOperator Reactor 适配、Redis Lua 原子脚本实现分布式令牌桶、网关层与应用层分层限流的职责分工与阈值配置指南。
响应式熔断器原理与实现:Resilience4j CircuitBreakerOperator Reactor 适配、CLOSED/OPEN/HALF_OPEN 状态机、失败率阈值与熔断时长配置、半开状态下的试探恢复、以及熔断事件监听与指标暴露。
响应式 HTTP 客户端负载均衡:Reactor Netty 与 Spring Cloud LoadBalancer 集成、自定义 ReactiveLoadBalancer 实现轮询/随机/加权策略、服务实例健康检查与动态刷新,以及连接池在负载均衡中的隔离配置。
响应式系统结构化日志完整方案:Logstash Logback Encoder JSON 格式输出、MDC ThreadLocal 在 Reactor 中的局限、Reactor Context 替代方案与 contextWrite 传播、WebFilter 自动 MDC 注入、日志采样与敏感字段脱敏。
响应式系统分布式追踪:Zipkin/Brave 与 OpenTelemetry Reactor 适配、ReactorContext 传递 trace context、手动创建 Span、 baggage 上下文传播,以及响应式 HTTP 客户端/服务端链路串联。
Micrometer 响应式指标收集全面实践:Counter/Timer/Gauge 的创建与注册、Reactor 流 metrics() 操作符埋点、MeterRegistry 绑定 Prometheus、SLA 分桶 histogram 与自定义标签在响应式系统中的上下文传播。