会员登录看起来只是“放一个登录按钮”,实际有三条路径:微信扫码、微信内公众号授权、以及授权后绑定手机号。三条路径的 AppID、回调地址和开关都不一样,配错时现象也很像——按钮不出现,或者授权后一直让绑定。

KingCMS X1 AI 助手示例
会员模块启用后,前台才开放 /member/login 与会员中心。

一、启用与入口

会员模块启用后,左侧出现「会员」菜单,前台开放登录与会员中心页面。登录方式在「设置 → 会员与登录 → 登录方式」(/admin/settings/member/login-methods);先点「显示高级设置」才会出现该分栏。

二、微信扫码(开放平台网站应用)

扫码登录用微信开放平台的「网站应用」,需要填该应用的 AppID 和 AppSecret——与微信支付 AppID 不是同一个。回调地址由「站点基本」里的站点网址自动生成,形如 https://<域名>/member/callback/wechat;管理员回调是 /admin/wechat/callback。使用前要在开放平台登记回调域名,站点须为 HTTPS。

配置完整后,后台登录页出现「微信扫码登录」,修改密码页出现「微信绑定」;会员登录页还要打开「微信登录」开关,才会出现会员扫码按钮。清空任一参数,会员与管理员的扫码入口都会隐藏;只关开关时,会员按钮隐藏,管理员扫码仍可用;已保存的绑定关系不会丢。

三、公众号网页授权(微信浏览器内)

这条路用公众号的 AppID 和 AppSecret,要求与微信支付 AppID 一致。两项都非空时,在微信浏览器里打开 /member/login 会自动发起网页授权,不再显示扫码页。需要先在公众平台把站点域名设为「网页授权域名」,回调地址是 https://<域名>/member/wechat/oa/callback,后台不显示,需自行登记。

KingCMS X1 商品详情页示例
会员登录后可享会员价、地址簿和订单认领。

四、绑定手机号

公众号授权后,首次登录会尽量保存微信昵称和头像,手机号为空。以下情况进入「绑定手机号」页:该微信没有对应会员、unionid 也没匹配到会员。填写 11 位中国大陆手机号并确认即可登录,规则是:

  • 号码已属于某个会员:把当前微信绑定到该会员;同号多条时用最早创建的一条;
  • 号码未注册:新建会员,昵称头像取自微信资料,手机号写入输入值;
  • 格式不对提示「请输入正确的 11 位手机号」;该微信已绑定其他会员则拒绝;
  • 绑定手机号不发短信验证码,也不校验号码归属,只按号码文本匹配。

五、会话与账号资料

会员会话有效期 12 小时,Cookie 名 kc_member,与后台管理员会话互不影响;同一浏览器重新扫码,旧会话失效。账号资料全部选填;手机号要求 1[3-9] 开头的 11 位,邮箱只校验格式。收货地址最多 50 条,订单保存下单时的快照,之后改地址不影响历史订单。

六、订单认领

未登录也能下单。付款页在同时满足以下条件时显示「记到我的账号」:订单仍待支付、还没关联会员、当前会员已填手机号、且会员手机号与订单联系人电话完全一致。订单支付完成或取消后不能再认领。

七、常见坑

  1. 扫码按钮不出现:检查开放平台 AppID/Secret 是否完整、会员登录页的微信开关是否打开;
  2. 微信里一直让绑定:公众号网页授权没配好,或该微信确实没有对应会员;
  3. 回调报错:确认站点网址是 HTTPS,且开放平台/公众平台登记的回调域名与站点一致;
  4. 提示登录状态过期:授权 state 过期或不匹配,重新发起即可;
  5. 会员被停用:提示「该会员已被停用」,不建立会话。

小结

扫码走开放平台,微信内走公众号授权,两者 AppID 不同、回调不同;授权后没有对应会员才需要绑定手机号。把这三段分开排查,比盯着登录按钮有效。