公众号粉丝
这篇解决什么
粉丝 openid 存在哪、同步和关注事件怎么回写。读完能对上 mp_user,不要把行当成商城 member_user。
默认端口 48080。先接入账号见 公众号接入。H5 登录见 微信公众号登录。
示意图:全量同步异步拉列表。关注事件即时插或改一行。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 粉丝 | @RequestMapping("/mp/user") | ruoyi-office/yudao-module-mp/yudao-module-mp-server/.../controller/admin/user/MpUserController.java |
| 同步 | POST /sync | @Async,mp:user:sync |
| 更新 | PUT /update | 备注、昵称、标签 |
| 粉丝表 | mp_user | MpUserDO |
| 管理端 | 列表、表单 | ruoyi-office-vben/apps/web-antd/src/views/mp/user/ |
官方菜单:粉丝管理 2099。查询 2100,修改 2101,同步 2102。
syncUser 分页 userList,每批最多 100 条 userInfoList 后 batchSaveUser。关注走 SubscribeHandler.saveUser,取关走 UnsubscribeHandler。模块里没有黑名单接口。
字段
subscribeStatus 复用 CommonStatusEnum:0 已关注,1 取消关注。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
openid | 本公众号内标识 | MpUserDO |
unionId | 开放平台唯一,可空 | 同上 |
subscribeStatus / subscribeTime | 关注状态、时间 | 同上 |
tagIds | 微信标签 id 列表,不是 mp_tag.id | 同上 |
nickname / headImageUrl | 资料 | 同上 |
2021 年底起,粉丝接口不再回昵称和头像,网页授权才能拿到。更新标签时后端会先取消旧标签再 batchTagging。PC 编辑表单目前只暴露昵称、备注,tagIds 后端有、页上没接。
mp_user 与 member_user、system_social_user 没有外键或同步代码。unionId 可以人工对,模块没做绑定。
不是会员用户
发券、下单看会员中心。这里只服务公众号运营:消息、模版、标签。同一人可以同时存在三张表。
先同步再发送
客服消息、模版消息都要本地粉丝行。新接入的号先点同步,或等用户关注回调插入。
按本仓库 DO 生成的 ER。账号 + openid 唯一。
配置与操作
走 粉丝管理(2099,/mp/user)。查询 2100,修改 2101,同步 2102。新号先 POST /sync(异步,每批最多 100 条),或等关注回调插行。subscribeStatus:0 已关注 / 1 取消。
行在 mp_user,不是 member_user。PC 表单目前只改昵称、备注;tagIds 是微信 tagId,页上没接。没有黑名单接口。客服 / 模版发送都要先有本地粉丝行。开启见 公众号功能设计。

本系统截图:公众号管理 → 粉丝管理。和会员用户没有外键。
