优雅地实现微信登录注册

2024-01-14 12:55:06 APP软件 投稿:一盘搜百科
摘要引言Hello 大家好,这里是Anyin。今天我们来聊一聊微信登录注册时遇到的一些事儿。在我们的业务系统中,一个用户在系统中肯定会有一个唯一标识,并且这个唯一标识一般是从系统外

引言

Hello 大家好,这里是Anyin。

今天我们来聊一聊微信登录注册时遇到的一些事儿。

在我们的业务系统中,一个用户在系统中肯定会有一个唯一标识,并且这个唯一标识一般是从系统外部获取的,而不是系统自动生成的,例如:手机号或者身份证。

我们在微信的场景下(微信公众号H5或者小程序),对于用户的唯一标识一般都是手机号或者openid。在正常情况下,我们遇到的都是一个用户只有一个微信号,一个微信号绑定了一个手机号,所以我们就认为三者的关系如下:

优雅地实现微信登录注册

 

但是,理想很丰满,现实很骨感,我们遇到的情况肯定不会如此的简单。

问题分析

当一个系统运行得足够久,用户量足够多,那么你总会遇到各种奇奇怪怪的问题。

在上一节,我们知道正常情况遇到的场景会比较简单,用户、微信号、手机号三者是1:1:1的关系,也就说三者可以等价,我用其中一个信息,总是可以查询出另外两个的信息,例如:我可以用手机号,查询出用户ID和微信openid。

所以,根据以上思路,我们很容易设计出用户表:cus_info ,基本表结构如下:

用户ID

微信openid

用户手机号

逻辑删除

其他字段

id

openid

mobile

del_flg

...

但是当遇到以下2个场景的时候,这个表结构设计就无法满足需求了。

一个用户2个微信号 有些用户是拥有两个微信号,并且绑定同一个手机号(这个逻辑可以通过微信换绑手机号实现)。

在这个场景下,一旦用户换了个微信号登录进入系统的时候,根据微信openid进行登录,因为表数据找不到该openid,则走注册流程;在注册的时候,又根据手机号查询用户信息,发现用户已经存在,返回登录流程,最终造成逻辑死循环。

优雅地实现微信登录注册

 

一个用户2个手机号 另外还有一些用户拥有2个手机号,并且绑定同一个手机号(这个逻辑在用户授权手机号的时候添加另外一个手机号实现)。

在这个场景下,第一次用户使用手机号A注册并登录,我们在后端绑定了手机号A和对应的微信openid;第二次用户使用手机号B注册并登录,这时候数据库会有2条记录,不同手机号相同的openid。这样子会导致在某些场景下(例如支付回调),根据openid获取用户信息的时候,找到2个用户,从而导致业务异常。

解决思路

以上2个问题,在不同的业务场景下,不同的人会有不同的解法。有以手机号作为用户的唯一标识,有以微信openid作为用户唯一标识。在这里,我们提供一个以手机号作为用户唯一标识的解法。

在这里,我们认为一个手机号就是一个用户,一个用户会有多个微信号。关系如下:

优雅地实现微信登录注册

 

一个用户2个微信号 针对该问题,我们在登录注册的时候,会通过逻辑控制,保证一个手机号只能找到一个微信openid。处理方式如下:

  • 根据当前的手机号查询到所有的微信openid,做逻辑删除处理
  • 根据当前的openid查询到所有的手机号,做逻辑删除处理
  • 根据当前手机号和openid查询是否存在记录,如果不存在则新增,如果存在则逻辑删除标识重置为正常。

一个用户2个手机号 针对该问题,我们在业务上做处理。因为我们认为一个手机号就是一个用户,如果一个用户拥有两个手机号,那么在我们系统上我们认为是两个用户,他们的数据是相互独立的。

另外在这个场景下,我们还需要提供一个手机号换绑的功能。这样当用户有2个手机号,也能给实现切换的需求。

方案实现

以上,相关的解决思路我们有了。那么接下来就是设计和编码。

根据以上,我们会设计如下2张表结构:

cus_info 用户信息表

用户ID

用户手机号

逻辑删除

其他字段

id

mobile

del_flg

...

cus_wx_info 用户和微信关联表

ID

用户手机号

微信AppId

微信openid

开放平台unionid

逻辑删除

其他字段

id

mobile

app_id

openid

unionid

del_flg

...

这里多添加了一个app_id的字段和unionid的字段,是用于当我们的业务涉及到多个入口,例如微信公众号H5入口和微信小程序。

不同的用户在微信公众号H5和微信小程序产生的openid可能一样也可能不一样,所以我们需要通过app_id来区分

同时为了关联在微信公众号H5和微信小程序的用户,我们会把微信公众号和微信小程序绑定到同一个开放平台,这个时候会产生一个unionid,通过该标识即可以找到微信公众号的用户,也可以找到微信小程序的用户。

接着我们实现一个注册方法。

@Service
public class CsInfoServiceImpl implements CsInfoService {
    @Autowired
    private CsInfoRepository csInfoRepository;

    @Autowired
    private CsWxInfoRepository csWxInfoRepository;

    @Autowired
    private CsInfoConvert csInfoConvert;
    
    @Override
    @Transactional(rollbackFor = Throwable.class, timeout = 60)
    public CsWxInfoDTO register(CsInfoRegisterDTO param) {
        // 根据手机号查询用户信息
        CsInfo info = csInfoRepository.infoByMobile(param.getMobile());
        Long id = info == null ? 0 : info.getId();
        // 如果用户不存在,则创建
        if(id == 0){
            id = csInfoRepository.create(param.getMobile(), param.getRegisterSource().getCode());
        }
        // 逻辑删除当前手机号绑定的openid
        // 逻辑删除当前openid绑定的手机号
        csWxInfoRepository.handleOpenidMobileUnique(param.getMobile(), param.getOpenid(), param.getAppId());
        
        // 保证当前手机号和openid在系统中1:1的关系
        CsWxInfo wxInfo = csWxInfoRepository.infoByMobileOpenid(param.getMobile(), param.getOpenid(), param.getAppId());
        if(wxInfo == null){
            wxInfo = new CsWxInfo();
            wxInfo.setAppId(param.getAppId());
            wxInfo.setMobile(param.getMobile());
            wxInfo.setOpenid(param.getOpenid());
            wxInfo.setUnionid(param.getUnionid());
            wxInfo.setAvatarUrl(param.getAvatarUrl());
            wxInfo.setNickName(param.getNickName());
            csWxInfoRepository.save(wxInfo);
        }else{
            CsWxInfo model = new CsWxInfo();
            model.setId(wxInfo.getId());
            model.setDelFlg(Integer.valueOf(DelFlgEnum.NORMAL.getCode()));
            csWxInfoRepository.updateById(model);
        }

        CsWxInfoDTO result = csInfoConvert.getCsWxInfoDTO(wxInfo);
        result.setInfoId(id);
        return result;
    }
}  

其中handleOpenidMobileUnique方法对应的SQL处理如下:

    <update id="loginDelByOpenIdExcludeMobile">
        update cs_wx_info set del_flg = 0 ,update_time = now()
        <where>
            del_flg = 1
            <if test="appId != null">
                and app_id = #{appId}
            </if>
            <if test="openid != null and openid != ''">
                and openid = #{openid}
            </if>
            <if test="mobile != null and mobile != ''">
                and mobile != #{mobile}
            </if>
        </where>
    </update>

    <update id="loginDelByMobileExcludeOpenid">
        update cs_wx_info set del_flg = 0 ,update_time = now()
        <where>
            del_flg = 1
            <if test="appId != null">
                and app_id = #{appId}
            </if>
            <if test="mobile != null and mobile != ''">
                and mobile = #{mobile}
            </if>
            <if test="openid != null and openid != ''">
                and openid != #{openid}
            </if>
        </where>
    </update>

最后

至此,关于微信登录注册遇到的一些小问题,我们找到了一个相对比较好的解决方案,你还不快实践到你自己项目上去?

相关源码地址:anyin-cloud: 生产级 Spring Cloud 脚手架

TAGS: 微信  系统  标识  唯一  登录  注册  我们  一个  
声明:一盘搜百科所有作品(图文、音视频)均由用户自行上传分享,仅供网友学习交流。若您的权利被侵害,请联系 88888@qq.com