# SH MQ 独立配置契约（2026-10-23）

- `svchall.fc.mq-enabled` 默认 false。配置类与消费者使用相同条件；平台注入 RabbitMQ host 不自动打开能力。
- `svchall.fc.consumer-app-key` 默认引用最终 `yh.app-auth.app-key`，不再直接使用陈旧 env 回退 100018。
- 只有显式启用且配置 host 才装配 MQ。启用时校验消费凭据键与签名键一致，再用已有 UserBase `getAppByCode(spring.application.name)` 核验注册行的 id/appKey/appCode 关系。
- 业务应用主身份是 application_info.id；id 可以不等于凭据 appKey。禁止拿 id 或 appCode 替代 MQ 协议的 *AppKey 字段。
- binding 继续动态生成 `fc.snapshot.v2.<自身消费凭据键>.*`，没有硬编码 100008。空键、通配符或额外 topic 段拒绝。
- 仅默认链修正不会移除 broker 已有旧 binding；旧绑定、topic 权限及独立 vhost 清理必须由 zcode 在另行授权的环境验证。
- 当前 MQ 投影入口的 DB 异常分支直接 basicNack(requeue=false)，并吞掉异常；不能只凭工厂 retryTemplate 配置宣称发生了三次 listener 重试。实际死信路由和恢复能力 NOT RUN，本补丁未重构这一策略。
- 本地 JSON 交接/ACK顺序测试不等于真实数据库提交或 broker 验证。核心 HTTP 签名收据链仍独立运行；本轮不处理 B5、不改 UserBase 模型、不启用对账。