在前面的設(shè)計(jì)和實(shí)現(xiàn)中，我們的微服務(wù)開(kāi)發(fā)平臺(tái)通過(guò)JustAuth來(lái)實(shí)現(xiàn)第三方授權(quán)登錄，通過(guò)集成公共組件，著實(shí)減少了很多工作量，大多數(shù)的第三方登錄直接通過(guò)配置就可以實(shí)現(xiàn)。而在第三方授權(quán)登錄中，微信小程序授權(quán)登錄和APP微信授權(quán)登錄是兩種特殊的第三方授權(quán)登錄。
??JustAuth之所以能夠?qū)⒍喾N第三方授權(quán)登錄服務(wù)整合在一起，抽象公共組件的原因是大多數(shù)的授權(quán)登錄服務(wù)器都是遵循OAuth2.0協(xié)議開(kāi)發(fā)，雖然略有不同但可通過(guò)適配器進(jìn)行轉(zhuǎn)換為統(tǒng)一接口。微信小程序授權(quán)登錄和APP的微信授權(quán)登錄也是OAutn2.0協(xié)議的授權(quán)登錄，但在對(duì)接的流程中不是完整的OAuth2.0對(duì)接流程。
??通常的第三方授權(quán)登錄過(guò)程中，獲取token的state和code是在回調(diào)客戶端url中獲取的，而微信小程序授權(quán)登錄和APP的微信授權(quán)登錄獲取token的state和code是使用微信提供的特定方法獲取到的，然后通過(guò)微信傳給客戶端,客戶端拿到code之后到后臺(tái)取獲取openid等微信用戶信息。然后，再進(jìn)行系統(tǒng)登錄相關(guān)操作。

創(chuàng)新互聯(lián)建站服務(wù)項(xiàng)目包括峽江網(wǎng)站建設(shè)、峽江網(wǎng)站制作、峽江網(wǎng)頁(yè)制作以及峽江網(wǎng)絡(luò)營(yíng)銷策劃等。多年來(lái)，我們專注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術(shù)優(yōu)勢(shì)、行業(yè)經(jīng)驗(yàn)、深度合作伙伴關(guān)系等，向廣大中小型企業(yè)、政府機(jī)構(gòu)等提供互聯(lián)網(wǎng)行業(yè)的解決方案，峽江網(wǎng)站推廣取得了明顯的社會(huì)效益與經(jīng)濟(jì)效益。目前，我們服務(wù)的客戶以成都為中心已經(jīng)輻射到峽江省份的部分城市，未來(lái)相信會(huì)繼續(xù)擴(kuò)大服務(wù)區(qū)域并繼續(xù)獲得客戶的支持與信任！

一、微信小程序授權(quán)登錄、注冊(cè)、綁定流程設(shè)計(jì)說(shuō)明

• 微信小程序授權(quán)登錄、注冊(cè)、綁定流程圖：

• 微信小程序授權(quán)登錄、注冊(cè)、綁定流程說(shuō)明：

1. 用戶進(jìn)入小程序。
2. 小程序前端通過(guò)從緩存中獲取是否有token來(lái)判定用戶是否登錄。
3. 如果未登錄，那么跳轉(zhuǎn)到小程序登錄頁(yè)。
4. 小程序前端執(zhí)行微信登錄方法wx.login獲取微信登錄的code（此時(shí)并未進(jìn)行微信授權(quán)登錄）。
5. 小程序前端通過(guò)code向業(yè)務(wù)后臺(tái)發(fā)送請(qǐng)求獲取用戶唯一的openid。
6. 業(yè)務(wù)系統(tǒng)根據(jù)openid或者unionid判斷該用戶是否綁定了業(yè)務(wù)用戶，并將是否綁定信息返回給前臺(tái)。
7. 如果沒(méi)有綁定過(guò)，那么前端展示微信授權(quán)登錄按鈕。
8. 用戶點(diǎn)擊“授權(quán)登錄”按鈕之后，小程序前端會(huì)獲取到加密的用戶信息。
9. 小程序前端將加密的用戶信息傳到業(yè)務(wù)后臺(tái)進(jìn)行解密。
10. 業(yè)務(wù)后臺(tái)收到加密用戶信息后，通過(guò)請(qǐng)求微信服務(wù)器解密用戶信息，并將用戶信息存儲(chǔ)到業(yè)務(wù)系統(tǒng)表。
11. 后臺(tái)將解密后的用戶信息（非私密信息）返回到小程序前臺(tái)。
12. 如果是沒(méi)有綁定的，那么小程序前臺(tái)彈出是否獲取當(dāng)前用戶手機(jī)號(hào)的彈出框。
13. 用戶選擇是否獲取微信綁定的手機(jī)號(hào)來(lái)注冊(cè)或綁定到業(yè)務(wù)系統(tǒng)的用戶。
14. 當(dāng)用戶點(diǎn)擊統(tǒng)一獲取手機(jī)號(hào)時(shí)，微信會(huì)返回加密后的手機(jī)號(hào)，然后前端將加密后的手機(jī)號(hào)發(fā)送到業(yè)務(wù)后臺(tái)解密。
15. 業(yè)務(wù)后臺(tái)獲取到手機(jī)號(hào)碼之后，會(huì)根據(jù)手機(jī)號(hào)碼在系統(tǒng)用戶表中進(jìn)行匹配，如果匹配到用戶，那么直接返回小程序用戶信息。
16. 當(dāng)用戶不同意獲取手機(jī)號(hào)時(shí)，那么小程序跳轉(zhuǎn)到輸入賬號(hào)密碼進(jìn)行綁定頁(yè)面。
17. 當(dāng)綁定操作執(zhí)行成功之后，微信小程序調(diào)用第三方登錄獲取token方式，向業(yè)務(wù)后臺(tái)獲取token。
18. 用戶小程序授權(quán)登錄、注冊(cè)、綁定成功。

二、微信小程序授權(quán)登錄、注冊(cè)、綁定業(yè)務(wù)后臺(tái)功能實(shí)現(xiàn)

??微信通過(guò)其開(kāi)放平臺(tái)提供小程序登錄功能接口，我們的業(yè)務(wù)服務(wù)可以通過(guò)小程序的登錄接口方便地獲取微信提供的用戶身份標(biāo)識(shí)，進(jìn)而將業(yè)務(wù)自身用戶體系和微信用戶相結(jié)合，從而更完美地在微信小程序中實(shí)現(xiàn)業(yè)務(wù)功能。
??微信小程序提供了對(duì)接登錄的SDK，我們只需要按照其官方文檔對(duì)接開(kāi)發(fā)即可。同時(shí)也有很多開(kāi)源組件將SDK再次進(jìn)行封裝，在業(yè)務(wù)開(kāi)發(fā)中可以更快速的集成小程序各個(gè)接口的調(diào)用。
??出于快速開(kāi)發(fā)的原則，同時(shí)也少走彎路、少踩坑，我們可以選擇一款實(shí)現(xiàn)比較完善的組件進(jìn)行微信小程序的對(duì)接。weixin-java-miniapp是集成微信小程序相關(guān)SDK操作的工具包，我們?cè)陧?xiàng)目中集成此工具包來(lái)實(shí)現(xiàn)微信小程序授權(quán)登錄。

1、引入weixin-java-miniapp相關(guān)maven依賴，目前發(fā)布版本為4.4.0正式版。

??一般在選擇開(kāi)源工具包時(shí)，我們不會(huì)選擇最新版，而是選擇穩(wěn)定版本，但是微信的開(kāi)放接口經(jīng)常變動(dòng)，這里為了能夠兼容最新的微信小程序接口，我們?cè)谝冒臅r(shí)候一定要選擇更新版本，否則會(huì)影響部分接口的調(diào)用。

......
    
......
        
        4.4.0
    
......
            
                com.github.binarywang
                weixin-java-miniapp
                ${weixin-java-miniapp.version}
            
......

2、在配置文件application-dev.yml、application-test.yml、application-prod.yml中新增微信小程序需要的配置項(xiàng)。

??關(guān)于小程序如何注冊(cè)，appid和appsecret如何獲取，這里不展開(kāi)講，微信開(kāi)放平臺(tái)有詳細(xì)的說(shuō)明文檔。

wx:
  miniapp:
    configs:
      - appid: #微信小程序appid
        secret: #微信小程序secret
        token: #微信小程序消息服務(wù)器配置的token
        aesKey: #微信小程序消息服務(wù)器配置的EncodingAESKey
        msgDataFormat: JSON

3、將weixin-java-miniapp配置類文件WxMaConfiguration.java和WxMaProperties.java添加到我們的工程中。

• WxMaConfiguration.java關(guān)鍵代碼

......
@Data
@ConfigurationProperties(prefix = "wx.miniapp")
public class WxMaProperties {

    private List configs;

    @Data
    public static class Config {
        /**
         * 設(shè)置微信小程序的appid
         */
        private String appid;

        /**
         * 設(shè)置微信小程序的Secret
         */
        private String secret;

        /**
         * 設(shè)置微信小程序消息服務(wù)器配置的token
         */
        private String token;

        /**
         * 設(shè)置微信小程序消息服務(wù)器配置的EncodingAESKey
         */
        private String aesKey;

        /**
         * 消息格式，XML或者JSON
         */
        private String msgDataFormat;
    }

}
......

• WxMaProperties.java關(guān)鍵代碼

......
    private final WxMaProperties properties;

    @Autowired
    public WxMaConfiguration(WxMaProperties properties) {
        this.properties = properties;
    }

    @Bean
    public WxMaService wxMaService() {
        List configs = this.properties.getConfigs();
        if (configs == null) {
            throw new WxRuntimeException("配置錯(cuò)誤！");
        }
        WxMaService maService = new WxMaServiceImpl();
        maService.setMultiConfigs(
            configs.stream()
                .map(a -> {
                    WxMaDefaultConfigImpl config = new WxMaDefaultConfigImpl();
                    config.setAppid(a.getAppid());
                    config.setSecret(a.getSecret());
                    config.setToken(a.getToken());
                    config.setAesKey(a.getAesKey());
                    config.setMsgDataFormat(a.getMsgDataFormat());
                    return config;
                }).collect(Collectors.toMap(WxMaDefaultConfigImpl::getAppid, a -> a, (o, n) -> o)));
        return maService;
    }
......

4、新建WxMaUserController.java用于實(shí)現(xiàn)微信小程序請(qǐng)求的相關(guān)接口。

• 實(shí)現(xiàn)小程序登錄的login接口，此接口會(huì)根據(jù)微信小程序前端傳來(lái)的code進(jìn)行獲取用戶session_key、openid/unionid，我們的業(yè)務(wù)系統(tǒng)會(huì)根據(jù)openid/unionid結(jié)合第三方登錄表進(jìn)行用戶匹配，如果存在該用戶則返回給小程序前臺(tái)已存在的用戶信息；如果不存在，說(shuō)明該用戶是第一次微信小程序登錄，那么我們將獲取到的微信唯一身份標(biāo)識(shí)加密，并返回微信小程序前臺(tái)進(jìn)行下一步綁定賬戶或注冊(cè)操作。

/**
     * 登陸接口
     */
    @ApiOperation(value = "小程序登錄接口")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "code", value = "小程序code", dataType="String", paramType = "query"),
    })
    @GetMapping("/login")
    public Result login(@PathVariable String appid, String code) {
        
        if (StringUtils.isBlank(code)) {
            return Result.error("code 不能為空");
        }

        if (!wxMaService.switchover(appid)) {
            throw new IllegalArgumentException(String.format("未找到對(duì)應(yīng)appid=[%s]的配置，請(qǐng)核實(shí)！", appid));
        }
    
        WeChatMiniAppLoginDTO weChatMiniAppLoginDTO = new WeChatMiniAppLoginDTO();
        try {
            WxMaJscode2SessionResult session = wxMaService.getUserService().getSessionInfo(code);
            weChatMiniAppLoginDTO.setOpenid(session.getOpenid());
            weChatMiniAppLoginDTO.setUnionid(session.getUnionid());
            // 通過(guò)openId獲取在系統(tǒng)中是否是已經(jīng)綁定過(guò)的用戶，如果沒(méi)有綁定，那么返回到前臺(tái)，提示需要綁定或者注冊(cè)用戶
            LambdaQueryWrapper socialLambdaQueryWrapper = new LambdaQueryWrapper<>();
            // 如果微信開(kāi)通了開(kāi)放平臺(tái)，那么各個(gè)渠道（小程序、公眾號(hào)等）都會(huì)有統(tǒng)一的unionid，如果沒(méi)開(kāi)通，就僅僅使用openId
            if (StringUtils.isBlank(session.getUnionid()))
            {
                socialLambdaQueryWrapper.eq(JustAuthSocial::getOpenId, session.getOpenid())
                        .eq(JustAuthSocial::getSource, "WECHAT_MINI_APP");
            }
            else
            {
                socialLambdaQueryWrapper.eq(JustAuthSocial::getUnionId, session.getUnionid())
                        .and(e -> e.eq(JustAuthSocial::getSource, "WECHAT_MINI_APP")
                                .or().eq(JustAuthSocial::getSource, "WECHAT_OPEN")
                                .or().eq(JustAuthSocial::getSource, "WECHAT_MP")
                                .or().eq(JustAuthSocial::getSource, "WECHAT_ENTERPRISE")
                                .or().eq(JustAuthSocial::getSource, "WECHAT_APP"));
            }
            JustAuthSocial justAuthSocial = justAuthSocialService.getOne(socialLambdaQueryWrapper, false);
            if (null == justAuthSocial)
            {
                weChatMiniAppLoginDTO.setUserInfoAlready(false);
                weChatMiniAppLoginDTO.setUserBindAlready(false);
                justAuthSocial = new JustAuthSocial();
                justAuthSocial.setAccessCode(session.getSessionKey());
                justAuthSocial.setOpenId(session.getOpenid());
                justAuthSocial.setUnionId(session.getUnionid());
                justAuthSocial.setSource("WECHAT_MINI_APP");
                justAuthSocialService.save(justAuthSocial);
            } else {
                justAuthSocial.setAccessCode(session.getSessionKey());
                justAuthSocialService.updateById(justAuthSocial);
            }
    
            // 將socialId進(jìn)行加密返回，用于前端進(jìn)行第三方登錄，獲取token
            DES des = new DES(Mode.CTS, Padding.PKCS5Padding, secretKey.getBytes(), secretKeySalt.getBytes());
            // 這里將source+uuid通過(guò)des加密作為key返回到前臺(tái)
            String socialKey = "WECHAT_MINI_APP" + StrPool.UNDERLINE + (StringUtils.isBlank(session.getUnionid()) ? session.getOpenid() : session.getUnionid());
            // 將socialKey放入緩存，默認(rèn)有效期2個(gè)小時(shí)，如果2個(gè)小時(shí)未完成驗(yàn)證，那么操作失效，重新獲取，在system:socialLoginExpiration配置
            redisTemplate.opsForValue().set(AuthConstant.SOCIAL_VALIDATION_PREFIX + socialKey, String.valueOf(justAuthSocial.getId()), socialLoginExpiration,
                    TimeUnit.SECONDS);
            String desSocialKey = des.encryptHex(socialKey);
            weChatMiniAppLoginDTO.setBindKey(desSocialKey);
            
            // 查詢是否綁定用戶
            // 判斷此第三方用戶是否被綁定到系統(tǒng)用戶
            Result