引言

Hello 大家好，這里是Anyin。

今天我們來聊一聊微信登錄注冊(cè)時(shí)遇到的一些事兒。

在我們的業(yè)務(wù)系統(tǒng)中，一個(gè)用戶在系統(tǒng)中肯定會(huì)有一個(gè)唯一標(biāo)識(shí)，并且這個(gè)唯一標(biāo)識(shí)一般是從系統(tǒng)外部獲取的，而不是系統(tǒng)自動(dòng)生成的，例如：手機(jī)號(hào)或者身份證。

我們?cè)谖⑿诺膱?chǎng)景下（微信公眾號(hào)H5或者小程序），對(duì)于用戶的唯一標(biāo)識(shí)一般都是手機(jī)號(hào)或者openid。在正常情況下，我們遇到的都是一個(gè)用戶只有一個(gè)微信號(hào)，一個(gè)微信號(hào)綁定了一個(gè)手機(jī)號(hào)，所以我們就認(rèn)為三者的關(guān)系如下：

但是，理想很豐滿，現(xiàn)實(shí)很骨感，我們遇到的情況肯定不會(huì)如此的簡(jiǎn)單。

問題分析

當(dāng)一個(gè)系統(tǒng)運(yùn)行得足夠久，用戶量足夠多，那么你總會(huì)遇到各種奇奇怪怪的問題。

在上一節(jié)，我們知道正常情況遇到的場(chǎng)景會(huì)比較簡(jiǎn)單，用戶、微信號(hào)、手機(jī)號(hào)三者是1:1:1的關(guān)系，也就說三者可以等價(jià)，我用其中一個(gè)信息，總是可以查詢出另外兩個(gè)的信息，例如：我可以用手機(jī)號(hào)，查詢出用戶ID和微信openid。

所以，根據(jù)以上思路，我們很容易設(shè)計(jì)出用戶表：cus_info ，基本表結(jié)構(gòu)如下：

但是當(dāng)遇到以下2個(gè)場(chǎng)景的時(shí)候，這個(gè)表結(jié)構(gòu)設(shè)計(jì)就無法滿足需求了。

一個(gè)用戶2個(gè)微信號(hào) 有些用戶是擁有兩個(gè)微信號(hào)，并且綁定同一個(gè)手機(jī)號(hào)（這個(gè)邏輯可以通過微信換綁手機(jī)號(hào)實(shí)現(xiàn)）。

在這個(gè)場(chǎng)景下，一旦用戶換了個(gè)微信號(hào)登錄進(jìn)入系統(tǒng)的時(shí)候，根據(jù)微信openid進(jìn)行登錄，因?yàn)楸頂?shù)據(jù)找不到該openid，則走注冊(cè)流程；在注冊(cè)的時(shí)候，又根據(jù)手機(jī)號(hào)查詢用戶信息，發(fā)現(xiàn)用戶已經(jīng)存在，返回登錄流程，最終造成邏輯死循環(huán)。

一個(gè)用戶2個(gè)手機(jī)號(hào) 另外還有一些用戶擁有2個(gè)手機(jī)號(hào)，并且綁定同一個(gè)手機(jī)號(hào)（這個(gè)邏輯在用戶授權(quán)手機(jī)號(hào)的時(shí)候添加另外一個(gè)手機(jī)號(hào)實(shí)現(xiàn)）。

在這個(gè)場(chǎng)景下，第一次用戶使用手機(jī)號(hào)A注冊(cè)并登錄，我們?cè)诤蠖私壎耸謾C(jī)號(hào)A和對(duì)應(yīng)的微信openid；第二次用戶使用手機(jī)號(hào)B注冊(cè)并登錄，這時(shí)候數(shù)據(jù)庫(kù)會(huì)有2條記錄，不同手機(jī)號(hào)相同的openid。這樣子會(huì)導(dǎo)致在某些場(chǎng)景下（例如支付回調(diào)），根據(jù)openid獲取用戶信息的時(shí)候，找到2個(gè)用戶，從而導(dǎo)致業(yè)務(wù)異常。

解決思路

以上2個(gè)問題，在不同的業(yè)務(wù)場(chǎng)景下，不同的人會(huì)有不同的解法。有以手機(jī)號(hào)作為用戶的唯一標(biāo)識(shí)，有以微信openid作為用戶唯一標(biāo)識(shí)。在這里，我們提供一個(gè)以手機(jī)號(hào)作為用戶唯一標(biāo)識(shí)的解法。

在這里，我們認(rèn)為一個(gè)手機(jī)號(hào)就是一個(gè)用戶，一個(gè)用戶會(huì)有多個(gè)微信號(hào)。關(guān)系如下：

一個(gè)用戶2個(gè)微信號(hào) 針對(duì)該問題，我們?cè)诘卿涀?cè)的時(shí)候，會(huì)通過邏輯控制，保證一個(gè)手機(jī)號(hào)只能找到一個(gè)微信openid。處理方式如下：

• 根據(jù)當(dāng)前的手機(jī)號(hào)查詢到所有的微信openid，做邏輯刪除處理
• 根據(jù)當(dāng)前的openid查詢到所有的手機(jī)號(hào)，做邏輯刪除處理
• 根據(jù)當(dāng)前手機(jī)號(hào)和openid查詢是否存在記錄，如果不存在則新增，如果存在則邏輯刪除標(biāo)識(shí)重置為正常。

一個(gè)用戶2個(gè)手機(jī)號(hào) 針對(duì)該問題，我們?cè)跇I(yè)務(wù)上做處理。因?yàn)槲覀冋J(rèn)為一個(gè)手機(jī)號(hào)就是一個(gè)用戶，如果一個(gè)用戶擁有兩個(gè)手機(jī)號(hào)，那么在我們系統(tǒng)上我們認(rèn)為是兩個(gè)用戶，他們的數(shù)據(jù)是相互獨(dú)立的。

另外在這個(gè)場(chǎng)景下，我們還需要提供一個(gè)手機(jī)號(hào)換綁的功能。這樣當(dāng)用戶有2個(gè)手機(jī)號(hào)，也能給實(shí)現(xiàn)切換的需求。

方案實(shí)現(xiàn)

以上，相關(guān)的解決思路我們有了。那么接下來就是設(shè)計(jì)和編碼。

根據(jù)以上，我們會(huì)設(shè)計(jì)如下2張表結(jié)構(gòu)：

cus_info 用戶信息表

cus_wx_info 用戶和微信關(guān)聯(lián)表

這里多添加了一個(gè)app_id的字段和unionid的字段，是用于當(dāng)我們的業(yè)務(wù)涉及到多個(gè)入口，例如微信公眾號(hào)H5入口和微信小程序。

不同的用戶在微信公眾號(hào)H5和微信小程序產(chǎn)生的openid可能一樣也可能不一樣，所以我們需要通過app_id來區(qū)分

同時(shí)為了關(guān)聯(lián)在微信公眾號(hào)H5和微信小程序的用戶，我們會(huì)把微信公眾號(hào)和微信小程序綁定到同一個(gè)開放平臺(tái)，這個(gè)時(shí)候會(huì)產(chǎn)生一個(gè)unionid，通過該標(biāo)識(shí)即可以找到微信公眾號(hào)的用戶，也可以找到微信小程序的用戶。

接著我們實(shí)現(xiàn)一個(gè)注冊(cè)方法。

@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) {
        // 根據(jù)手機(jī)號(hào)查詢用戶信息
        CsInfo info = csInfoRepository.infoByMobile(param.getMobile());
        Long id = info == null ? 0 : info.getId();
        // 如果用戶不存在，則創(chuàng)建
        if(id == 0){
            id = csInfoRepository.create(param.getMobile(), param.getRegisterSource().getCode());
        }
        // 邏輯刪除當(dāng)前手機(jī)號(hào)綁定的openid
        // 邏輯刪除當(dāng)前openid綁定的手機(jī)號(hào)
        csWxInfoRepository.handleOpenidMobileUnique(param.getMobile(), param.getOpenid(), param.getAppId());
        
        // 保證當(dāng)前手機(jī)號(hào)和openid在系統(tǒng)中1:1的關(guān)系
        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方法對(duì)應(yīng)的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>

最后

至此，關(guān)于微信登錄注冊(cè)遇到的一些小問題，我們找到了一個(gè)相對(duì)比較好的解決方案，你還不快實(shí)踐到你自己項(xiàng)目上去？

相關(guān)源碼地址：anyin-cloud: 生產(chǎn)級(jí) Spring Cloud 腳手架