公众号粉丝

公众号粉丝页用于查看和维护指定公众号下的微信粉丝资料。前端页面位于 apps/web-antd/src/views/mp/user，后端接口位于 MpUserController，支持按公众号查询粉丝、编辑粉丝信息，并从微信公众号同步粉丝数据。

功能边界

能力	接口	说明
粉丝分页	GET /mp/user/page	按公众号、昵称、openid 等条件查询
粉丝详情	GET /mp/user/get?id=	编辑弹窗读取单个粉丝
更新粉丝	PUT /mp/user/update	维护备注、标签等运营字段
同步粉丝	POST /mp/user/sync?accountId=	从微信侧拉取粉丝信息，耗时操作
标签同步	POST /mp/tag/sync?accountId=	粉丝标签依赖公众号标签数据

同步链路

运营使用建议

• 先选择公众号再同步：页面不会自动猜测账号，同步前必须选择明确的 accountId。
• 同步是异步感知操作：按钮提示“同步需要一段时间”，大号粉丝量较大时建议稍后刷新列表。
• 标签先同步再使用：如果粉丝标签显示异常，先同步公众号标签，再同步粉丝。
• 本地备注用于运营：备注、标签等字段可辅助客服和营销分层，但不建议覆盖微信侧关键身份字段。

排查清单

现象	优先检查
点击同步提示请选择公众号	页面左侧账号下拉是否有值；账号列表接口是否返回
同步后粉丝为空	AppSecret 是否有效；公众号权限是否支持获取粉丝；微信接口是否限流
标签显示不完整	是否同步过公众号标签；粉丝标签 ID 与本地标签是否匹配
编辑失败	权限 mp:user:update；请求体字段是否符合后端 VO 校验