Middleware/mq-starter
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
15 Commits 2 Branches 0 Tags
f0dc78599812c4f3d1ecbb530ca59a55db40b8ce
Commit Graph

15 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
hongawen
f0dc785998 fix(mq-starter): 落实 opus review 反馈（含 1 个 Critical 静默丢消息） 
- [Critical] dispatcher errorHandler 抛异常时仍保证 markFail + 抛原始异常（safeOnError 隔离）：
  否则去重标记停在 processing，reclaim 重投被去重挡掉并 ACK → 静默丢消息
- [Important] 重试耗尽回调携带完整 payload（reclaim 解码 body，不再传 null）
- [Important] reclaim 默认 idle 5s→30s，避免多实例误 reclaim in-flight 消息；注释 at-least-once 语义
- [Important] idempotent=true 但无 MqIdempotentStore bean 时 start() 告警
- core 引入 slf4j-api(provided)；批量失败 / errorHandler 失败均记日志
- errorHandler bean 未找到时抛带 topic/group 的清晰错误
- 文档化已知限制（批量无 idle flush、去重 fail→reopen 非原子）
- 全仓 29 测试绿（含连真实 redis 的 IT）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 20:48:53 +08:00
hongawen
dd2b933c08 feat(mq-starter): redis-stream 重试可放量（PEL reclaim + 超限落库） 
- MqSubscription 增加 retryExhaustedHandler；registry 从 errorHandler 接线 RETRY_EXHAUSTED 回调
- redis driver 每轮 reclaim PEL：connection 层 xClaim 认领超 idle 消息并使 delivery+1
  - delivery <= maxRetry：重投消费，成功 ACK / 失败留 PEL
  - delivery > maxRetry：回调 retryExhaustedHandler 落库 + ACK 终止，不再卡队列
- 可配 reclaimMinIdleMs（默认 5000ms，对齐 legacy 5s 延迟）；4 参构造 + 3 参重载
- 集成测试连真实 redis 验证 重试耗尽→落库→ACK；全仓 28 测试绿

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 20:17:05 +08:00
hongawen
407df30457 feat(mq-starter-redis-stream): 去重 Redis 默认实现 RedisMqIdempotentStore 
- 实现 MqIdempotentStore：setIfAbsent 原子占用 + processing/success/fail 状态机 + TTL
- 修正 legacy 读写 key 不一致缺陷（读写统一前缀键）
- autoconfig 在 redis-stream 模式装配为默认 store（@ConditionalOnMissingBean）
- 集成测试连真实 redis 验证状态机；@Bean 声明契约护栏

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 19:59:07 +08:00
hongawen
4ee6685cc5 feat(mq-starter-core): 消费侧通用化 去重/批量/异常落库（注解+SPI 织入） 
- 新增 MqConsumeDispatcher 消费处理链：去重→(攒批)→业务→成功标记/异常落库
- 新增 SPI：MqIdempotentStore（去重，修正 legacy 读写 key 不一致缺陷）、
  MqConsumeErrorHandler + MqErrorIdentity（异常落库 SINGLE/RETRY_EXHAUSTED）
- @MqListener 扩展 idempotent/errorHandler；BPP 识别 List<T> 批量签名并解析元素类型
- MqListenerRegistry 织入 dispatcher，按注解装配 store/errorHandler；
  autoconfig 经 ObjectProvider/ApplicationContext 注入（4 参构造，保留 2 参重载）
- 重试统一交 driver MQ 原生重投（单条异常 rethrow）；批量入库失败落库后吞掉不卡队列
- 19 个单测全绿（-DforkCount=0）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 19:49:22 +08:00
hongawen
e5991718e6 test(mq-starter): driver autoconfig 加 @AutoConfigureBefore 注解契约护栏 
Rocket / RedisStream driver autoconfig 各加一个护栏测试，断言
@AutoConfigureBefore(MqCoreAutoConfiguration) 注解存在——防止重构误删导致 core 在
driver 前装配、MqTemplate/MqListenerRegistry 不装配的回归（最终 review I1）。
以注解契约守护、不 refresh context（规避本模块 spring 版本不一致：rocketmq-spring
2.2.3 与父 pom spring-boot 2.3.12 的 spring-core 缺 ApplicationStartup）；真实装配
结果由 cn-data-platform MqSliceWiringTest 在正确 spring 版本下覆盖。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 14:08:26 +08:00
hongawen
9f6ffad77c fix(mq-starter): driver autoconfig 加 @AutoConfigureBefore(MqCoreAutoConfiguration) 
真实 autoconfig 顺序按类名字母序，com.njcn.mq.autoconfig.MqCoreAutoConfiguration
先于 com.njcn.mq.driver.* 处理，core 的 @ConditionalOnBean(MqDriver) 在 driver
bean 注册前求值失败，导致 MqTemplate / MqListenerRegistry 在真实应用中均不装配。
两个 driver autoconfig 各加 @AutoConfigureBefore(MqCoreAutoConfiguration.class)，
保证 driver 先于 core 装配。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 12:01:41 +08:00
hongawen
f2ea48dce0 feat(mq-spring-boot-starter): 聚合三模块，业务方单坐标接入 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 05:30:28 +08:00
hongawen
597b872b4f feat(mq-starter-rocketmq): rocket driver 发送(模板)+编程式消费(DefaultMQPushConsumer) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 05:25:55 +08:00
hongawen
acc745c52e feat(mq-starter-redis-stream): redis driver 复用 Phase1 低层件 + 薄收发循环 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 05:17:27 +08:00
hongawen
795d4f2629 feat(mq-starter-core): 自动装配 + spring.factories 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 05:06:36 +08:00
hongawen
016590099a feat(mq-starter-core): MqListenerRegistry 端点→driver.subscribe + payload/MqContext 调用 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 04:58:59 +08:00
hongawen
744115ca97 feat(mq-starter-core): @MqListener 扫描 → MqListenerEndpoint 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 04:53:01 +08:00
hongawen
871aef64f8 feat(mq-starter-core): 发送门面 MqTemplate + DefaultMqTemplate 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 04:48:19 +08:00
hongawen
491b83de94 feat(mq-starter): 多模块脚手架 + core 信封/SPI/注解 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 04:41:54 +08:00
hongawen
69db3fdd01 chore: 初始化 mq-starter 仓库（.gitignore + README） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 21:14:37 +08:00