公众号粉丝

本章节，讲解公众号粉丝的相关内容，包括关注、取消关注等等，对应 [《微信公众号官方文档 —— 获取用户列表》 (opens new window)](https://developers.weixin.qq.com/doc/offiaccount/User_Management/Getting_a_User_List.html) 文档。

![粉丝管理](https://note.lazzman.com:18084/media/202404/2024-04-30_084340_9626100.9101879978379975.png)

## [#](#_1-表结构) 1. 表结构

公众号粉丝对应 `mp_user` 表，结构如下图所示：

![表结构](https://note.lazzman.com:18084/media/202404/2024-04-30_084340_9906980.8341562065611786.png)

注意，自 2021-12-27 开始，公众号接口不再返回头像和昵称，只能通过微信公众号的网页登录获取。因此，表中的 `avatar` 和 `nickname` 字段，往往是空的。

## [#](#_2-粉丝管理界面) 2. 粉丝管理界面

## [#](#_3-同步粉丝) 3. 同步粉丝

点击粉丝管理界面的【同步】按钮，可以 **异步** 从公众号同步所有的粉丝信息，存储到 `mp_user` 表中。如果你的粉丝较多，可能需要等待一段时间。

对应后端的 [MpUserServiceImpl (opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/user/MpUserServiceImpl.java#L95-L161) 的 `syncUser` 方法。

用户关注公众号时，会触发 [SubscribeHandler (opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/handler/user/SubscribeHandler.java) 处理器，新增或修改 `mp_user` 粉丝信息。

![SubscribeHandler](https://note.lazzman.com:18084/media/202404/2024-04-30_084340_9920920.500879508300286.png)

用户取消关注公众号时，会触发 [UnsubscribeHandler (opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/handler/user/UnsubscribeHandler.java) 处理器，标记 `mp_user` 粉丝信息为取消关注，设置 `subscribe_status` 字段为 0。

![UnsubscribeHandler](https://note.lazzman.com:18084/media/202404/2024-04-30_084340_9810690.04739061180221782.png)