一、前言在之前的系列文章中我写了 LikeShop 多商户版的商品模块、分账对接和安全加固。这一篇聚焦用户体系的入口——微信登录与会员体系。微信登录是 LikeShop 用户获取的第一个环节也是最容易出问题的环节之一。有一个真实的踩坑案例开发者在配置微信小程序登录时前端调起wx.login后后台一直返回 401 提示“签名错误”。检查了 appid、secret、支付密钥都没问题最后发现多商户版需要在平台后台额外配置一个开放平台第三方平台 AppID因为要处理商家独立登录态。这个坑的根源是多商户版的登录态体系和单商户版有本质区别。单商户版一套小程序对应一个商户登录态是扁平的多商户版平台下有几十上百个商户每个商户可能都有自己的小程序但用户是平台级的登录态需要在服务端统一管理。这篇文章就从 OAuth 流程、用户表设计、会员体系三个层面把 LikeShop 多商户版的用户体系拆开讲清楚。二、微信登录 OAuth 流程2.1 登录方式的配置项LikeShop 的微信登录不是“写死”的而是通过后台配置开关控制的。公共配置接口GET /shopapi/config/getConfig返回的登录相关参数如下参数名类型说明register_wayarray注册方式1-手机号码注册login_wayarray登录方式1-手机号码密码登录2-手机短信验证码登录is_mobile_register_codeint手机号码注册需验证码0-关闭1-开启coerce_mobileint强制绑定手机0-关闭1-开启h5_wechat_authint公众号-微信授权登录0-关闭1-开启h5_auto_wechat_authint公众号-自动微信授权登录0-关闭1-开启mnp_wechat_authint微信小程序-微信授权登录0-关闭1-开启mnp_auto_wechat_authint微信小程序-自动微信授权登录0-关闭1-开启app_wechat_authintAPP-微信授权登录0-关闭1-开启h5_auto_wechat_auth和mnp_auto_wechat_auth的区别需要特别理解“授权登录”需要用户手动点击授权按钮“自动授权登录”是页面加载时静默触发授权。自动授权的用户体验更好但需要用户之前已经授权过否则微信会直接跳转到授权页。2.2 小程序端 OAuth 流程微信小程序的登录流程和 H5 完全不同。小程序的流程是通过wx.login()获取 code 再换取 openid而 H5 在微信环境下走公众号授权。小程序端的完整登录链路如下用户点击登录 ↓ ① wx.login() 获取 code ↓ ② 将 code 发送到服务端 /shopapi/user/mnpLogin ↓ ③ 服务端调用微信接口换取 openid 和 session_key ↓ ④ 服务端查找或创建用户生成 token 返回 ↓ ⑤ 前端将 token 存储到本地 ↓ ⑥ 后续请求自动携带 token这里有一个关键约束code 只能使用一次且有效期很短。前端拿到 code 后应立刻发送给服务端不要在本地缓存。二开时如果遇到“登录返回 401”或“code 无效”的报错通常是因为 code 被重复使用或超时了。2.3 多商户版的核心差异商家独立登录态多商户版和单商户版在微信登录上最大的区别是多商户版需要处理商家独立登录态。在多商户版中平台、商户、C 端用户是三个独立的登录态体系。平台端管理商户和审核商户端管理自己的店铺和商品C 端用户是购物者。这三套登录态共用同一个微信授权体系但 session 是隔离的。技术实现上这意味着同一微信用户在不同角色下的身份标识不能混用。平台管理员登录时生成的 token 只能访问管理后台接口C 端用户登录时生成的 token 只能访问商城接口。二开时如果要在某个端新增登录入口必须明确这个入口对应哪个角色体系生成的 token 要限定在对应的权限范围内。2.4 微信配置的关键步骤多商户版的微信配置比单商户版多了一个步骤。除了配置小程序自身的 AppID 和 AppSecret 之外还需要在平台后台的“微信设置”中额外填写开放平台第三方平台 AppID。公众号的服务器配置也需要在 LikeShop 后台和微信公众号后台同步配置 Token 和 EncodingAESKey。配置完成后用户关注公众号即可触发微信授权登录流程。三、用户表设计3.1 ls_user 用户主表ls_user是整个系统的用户中心所有与用户相关的数据都围绕这张表展开。字段名数据类型注释idint主键snvarchar会员码唯一标识nicknamevarchar用户昵称avatarvarchar用户头像mobilevarchar手机号码leveltinyint用户等级group_idint所属分组idsextinyint性别0-未知1-男2-女user_moneydecimal用户余额earningsdecimal佣金收益level字段是会员体系的核心。如果你要做会员等级折扣这个字段就是判断依据。等级值越大通常对应更高的折扣比例。user_money是余额字段退款到余额、分销佣金提现等操作都会修改这个字段修改时要注意并发安全——LikeShop 通过ls_account_log账户流水表来保证资金变动的可追溯性。3.2 用户与 openid 的映射关系多商户版中用户和微信 openid 的映射关系不是直接存在ls_user表中而是通过独立的授权表管理。微信的标识体系有两个层级openid 是用户在某个具体应用公众号/小程序中的唯一标识unionid 是用户在同一个微信开放平台账号下的全局唯一标识。在多商户场景下一个用户可能同时使用多个商户的小程序。如果每个小程序都生成独立的 openid同一个用户在不同商户的小程序下会被识别为不同的人无法实现“全终端数据打通”。LikeShop 的解决方案是以 unionid 作为用户的全局标识。用户在任一终端授权登录时服务端优先用 unionid 查找用户如果找到则直接关联如果找不到再用 openid 创建新用户。二开时如果新增了微信登录入口比如抖音小程序需要确保这个入口也能获取到 unionid 并写入授权表否则跨端用户无法关联。3.3 多商户版的用户隔离问题这里有一个需要特别说明的设计LikeShop 多商户版的 C 端用户是平台级的不是商户级的。用户在整个平台注册一次就能在所有商户的店铺下单。但用户的会员等级、余额、积分也是平台级的。这对二开的影响是如果业务要求“不同商户下的会员等级独立”需要在ls_user之外新增一张“用户-商户关联表”存储用户在每个商户下的等级和积分。但这样做会带来一个后果——平台级的会员权益比如全平台通用的余额和商户级的权益需要分开管理复杂度会上升。四、会员体系设计4.1 会员等级LikeShop 的会员等级体系以成长值作为升级条件。后台设置会员等级用于商品的折扣。会员根据设定好的等级成长值升级等级成长值通过日常消费积累。赠送成长值支持订单支付、订单发货、订单完成、订单结算时赠送防止刷取成长值现象。赠送的成长值不会收回。新增会员等级需要填写等级名称、成长值、等级图标、等级背景图以及会员折扣等字段。等级折扣的设置有两个选项0-无等级折扣1-参与等级折扣。4.2 会员等级与商品价格的联动会员等级与商品价格的联动核心在价格计算的优先级上。之前写商品模块时提到过LikeShop 的价格优先级是活动价 会员价 原价。这意味着如果商品参与了秒杀或拼团活动会员价不再生效成交价就是活动价。二开时如果要求“会员价在活动价基础上再打折”需要修改价格计算的优先级但这样做会导致活动利润被进一步压缩需要与运营团队确认可行性。4.3 会员体系与营销模块的协作会员体系不是孤立运转的它和营销模块优惠券、积分、分销的协作关系如下模块与会员体系的交互优惠券会员可使用优惠券但优惠券不改变会员等级积分会员消费可获得积分积分可抵扣订单金额分销会员可成为分销员佣金计入earnings字段成长值订单支付/发货/完成/结算时赠送用于等级升级4.4 二开扩展点新增会员等级条件目前 LikeShop 的等级条件是成长值。如果要新增“按累计消费金额”的等级条件需要在等级配置表中新增字段并在用户成长值更新的 Logic 中增加判断逻辑。会员等级过期机制当前 LikeShop 没有等级过期机制。如果业务要求“会员等级每 6 个月重新计算”需要新增一个定时任务定期扫描用户成长值并重新计算等级。用户标签与分组ls_user.group_id字段用于用户分组。如果要做更复杂的用户标签体系一个用户可以打多个标签需要新建用户-标签关联表而不是在ls_user中堆砌字段。五、二开避坑清单坑一多商户版微信登录 401 签名错误。最常见的原因是只配置了商户自己的小程序信息没有在平台后台配置开放平台第三方平台 AppID。多商户版必须额外配置这一项。坑二小程序 code 复用。wx.login()获取的 code 只能使用一次。每次登录都需要重新调用wx.login()获取新的 code。坑三token 失效后登录页循环跳转。如果登录页本身也需要请求接口token 失效时登录页的请求也会返回-1导致反复跳转自己。解决方案是在请求封装中排除登录相关的接口。坑四跨端用户无法关联。如果新增的微信登录入口没有获取 unionid同一个用户在不同终端会被识别为不同的人。所有微信登录入口都必须确保 unionid 被正确写入授权表。坑五直接修改ls_user的 level 字段。会员等级变更应该走UserLogic中定义的方法确保等级变更和成长值计算在同一事务中完成避免出现“等级已升级但成长值未更新”的不一致情况。六、总结LikeShop 多商户版的微信登录与会员体系核心可以概括为三条线OAuth 流程小程序端通过wx.login()获取 code 换取 openidH5 端走公众号授权。登录方式通过后台配置开关控制。多商户版需要额外配置开放平台第三方平台 AppID 来处理商家独立登录态。用户表设计ls_user是用户中心level字段是会员等级user_money是余额earnings是佣金收益。用户与微信的映射通过授权表管理以 unionid 作为全局标识。会员体系以成长值为升级条件成长值通过日常消费积累。价格优先级为活动价 会员价 原价。会员体系与优惠券、积分、分销模块协同工作。二开时守住两条底线所有微信登录入口必须获取 unionid、会员等级变更必须走 UserLogic。本文基于 LikeShop 多商户版 源码及官方开发文档整理不同版本的字段定义和接口路径可能略有差异请以实际源码和对应版本的开发文档为准。