Files
core/.workbuddy/memory/2026-04-07.md
赵忠林 ca3651165c feat(sync): 实现MQ消息队列用户同步功能
- 添加RabbitMQ相关配置,支持消息确认与回退机制
- 新增统一消息实体SyncMessage,支持多种同步事件类型
- 实现RabbitMQ消息生产者RabbitMQSyncProducer,包含回调处理和用户同步消息发送
- 实现用户同步消息消费者UserSyncConsumer,支持消息重试和死信队列处理
- UserSyncService新增Map参数方法,适配MQ消息同步调用
- QrLoginServiceImpl改用MQ消息异步同步用户数据,替代原直接调用方式
- 应用配置新增RabbitMQ连接配置及MQ开关开关控制
- 前端接口和组件调整,支持扫码登录绑定手机号及跳转逻辑完善
2026-04-07 02:44:02 +08:00

4.4 KiB
Raw Blame History

2026-04-07 工作记录

微信扫码登录问题修复

  1. 修复了UserSyncService中tenant_id字段名问题从tenantId改为tenant_id
  2. 同时发送两种格式的tenant_id字段确保兼容性
  3. 修改了WxOfficialController在同步前从数据库重新加载用户对象
  4. 添加了详细的调试日志便于问题排查

待解决问题

  1. websopy侧app_user_cache同步失败tenant_id为null
  2. 扫码成功后需跳转到强制绑定手机号页面
  3. 注册成功后应跳转到控制台/console

websopy-pc前端修改需求分析

  1. 状态检查逻辑更新需处理新的nextAction字段bind_phone, redirect, login等
  2. 新增绑定手机号页面:用于新用户绑定手机号流程
  3. 页面跳转逻辑:登录成功/绑定成功后跳转到/console
  4. API调用更新:适应新的响应字段格式

前端代码已完成的修改

  1. API接口修改

    • 更新QRLoginStatusResult接口新增nextAction、redirectUrl、successMessage、needBindPhone等字段
    • 修改checkQRLoginStatus函数使用真实后端API调用
    • 新增bindPhoneForQrLogin函数处理绑定手机号API调用
    • 修改generateQRLoginToken函数使用真实后端API调用
  2. 状态管理修改

    • 更新auth store接口添加bindPhoneForQRLogin方法
    • 修改checkQRStatus方法支持新的返回字段处理
    • 添加绑定手机号处理逻辑
  3. 组件修改

    • 创建BindPhone组件用于处理需要绑定手机号的场景
    • 修改QRLogin组件支持根据nextAction显示不同UI自动处理绑定手机号流程
    • 组件现在可以正确处理:
      • nextAction: 'bind_phone' → 显示绑定手机号表单
      • nextAction: 'redirect' → 自动跳转到/console
      • needBindPhone: true → 显示绑定提示
  4. 完整流程支持

    • 用户扫码登录 → 后端返回nextAction: 'bind_phone' → 前端显示绑定手机号页面
    • 用户输入手机号和验证码 → 调用绑定手机号API → 绑定成功后自动登录并跳转/console
    • 用户已有手机号 → 后端返回nextAction: 'redirect' → 前端自动跳转到/console

后端修改完成

  1. QrLoginStatusResponse新增字段
    • nextAction: 下一步操作指示
    • redirectUrl: 跳转URL当nextAction为redirect时
    • successMessage: 成功消息
  2. QrLoginServiceImpl逻辑更新
    • 用户没有手机号时nextAction设为bind_phone
    • 用户有手机号且登录成功时nextAction设为redirectredirectUrl设为/console

扫码登录用户同步时机修改 (01:58)

修改内容

  1. WxOfficialController.java - 移除新用户注册时立即同步的代码

    • processWxUser() 方法中,新用户创建后不再立即同步到 websopy
    • findOrCreateUserForOauth() 方法中同样处理
  2. QrLoginServiceImpl.java - 在绑定手机号成功后同步

    • 新增 UserSyncService 注入
    • 在 bindPhone() 方法中,绑定手机号成功后从数据库重新加载用户并同步

目的

确保用户数据同步到 websopy 时,手机号字段已有值,避免无效的缓存数据。

MQ消息队列实现 (02:40)

创建的文件

  1. SyncMessage.java - 统一消息实体

    • 位置: com.gxwebsoft.common.mq.message
    • 支持 USER_SYNC, TENANT_SYNC 等消息类型
    • 支持 CREATE, UPDATE, DELETE 事件类型
  2. SyncMessageProducer.java - 消息生产者接口

    • 位置: com.gxwebsoft.common.mq.producer
    • 预留抽象层便于将来切换到RocketMQ
  3. RabbitMQConfig.java - RabbitMQ配置类

    • 位置: com.gxwebsoft.common.mq.config
    • 定义交换机、队列、死信队列
    • 配置JSON序列化
  4. RabbitMQSyncProducer.java - RabbitMQ生产者实现

    • 位置: com.gxwebsoft.common.mq.producer.impl
    • 实现确认回调和Return回调
  5. UserSyncConsumer.java - 用户同步消费者

    • 位置: com.gxwebsoft.common.mq.consumer
    • 监听用户同步消息调用UserSyncService同步到websopy
    • 支持重试机制和死信队列

修改的文件

  1. pom.xml - 添加 spring-boot-starter-amqp 依赖
  2. UserSyncService.java - 添加Map参数的重载方法
  3. QrLoginServiceImpl.java - 改用MQ发送消息
  4. application.yml - 添加RabbitMQ配置

使用方式

配置 sync.mq.enabled: false 可临时禁用MQ回退到原有直接同步方式。