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

12 Commits

Author SHA1 Message Date
hongawen
8c39399d09 feat(mq-starter-core): @MqListener batchSize 与首参 List 错配时打 WARN 软校验 
走不走批量始终只由首参是否 List 决定，错配不阻断启动：
- batchSize>1 但首参非 List → WARN 提示 batchSize 不生效、按单条逐一回调
- 首参 List 但 batchSize<=1 → WARN 提示将按 1 条一批回调

测试：ListAppender 捕获日志，覆盖两个错配方向 + 匹配时无 WARN。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-14 04:19:17 +01:00
hongawen
e660afe2a2 fix(mq-starter): 去重跳过区分 processing/success，processing 残留不 ACK 避免静默丢消息 
tryAcquire 返回 false 的两类跳过此前一律静默 return，导致 driver 无差别 ACK：
消费者在 markSuccess/markFail 前崩溃残留的 processing 标记，会被当成"已处理"
而 ACK，该消息从未成功消费却被丢弃（Critical 静默丢消息）。

- MqIdempotentStore 新增 isCompleted(key)，默认 true 保持旧行为，状态机实现须覆写
- MqConsumeDispatcher：跳过时按 isCompleted 分流——success 正常 return 让 driver ACK；
  仍 processing 则抛 MqMessageInProgressException（新，纯控制流信号、不带栈）让 driver 不 ACK
- RedisMqIdempotentStore.isCompleted 仅 success 视为完成；RedisStreamMqDriver 捕获信号异常时留 PEL 待重投
- 补 dispatcher 两类跳过 + store isCompleted 语义单测

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 20:41:02 +08:00
hongawen
886c02ff96 fix(mq-starter): 修复启动 fail-fast 校验 review 发现的缺陷（relaxed binding / 逃生开关 / redis 假地址） 
workflow 多智能体 review 后修复：

- rocketmq 探测改用 Binder 读 rocketmq.name-server，与 driver（RocketMQProperties）同源、
  享受 relaxed binding，修复 camelCase(rocketmq.nameServer) 被误判为「未配置」而错误 fail-fast
- MqStartupChecks 逃生开关只认严格 false（忽略大小写/空白），缺省或非法值一律继续校验，
  不再因非法布尔值（如 enabled=disabled）抛类型转换异常炸掉启动
- redis 探测 target() 对 cluster/sentinel 回退到指向真实配置项的文案，
  不再假报使用者从未配过的 localhost:6379
- 补齐回归测试：camelCase 键 / 非法开关值继续校验 / host:port 提示分支 / cluster 回退
  （core 5、redis-stream 5、rocketmq 5，全绿）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 14:06:05 +08:00
hongawen
5c4a29e1e1 feat(mq-starter-core): 启动期校验 mq.type 有对应 MqDriver（③ fail-fast） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 10:34:50 +08:00
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
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
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