手把手教你如何獲取微信使用者openid

2023-02-14 06:00:31

1、前言

隨著技術的發展，微信的一系列服務滲透進了我們的生活，但是我們應該怎樣進行微信方面的開發呢。相信很多的小夥伴們都很渴望知道吧。這篇文章就是來解決大家的一些疑惑的。首先我們要進行相關的開發的話，那麼我們需要先獲取微信的openid。那麼我們英愛怎樣獲取呢？這裡我會介紹兩種方式。

2、手工方式

官方檔案

2.1、設定域名

（1）.註冊對應的公眾號找到下圖位置

（2）. 在natapp.cn上購買自己的用於微信開發的域名

註冊地址

哈哈，這個網站上面的域名也不是特別的貴呀，我在這上面買的一個域名為期一個月的話也就才12元，且改型別的屬於二級域名，是已經備過案的，所以也就不需要備案。

（3）. 下載對應的使用者端進行啟動

在windows上啟動的命令

natapp -authtoken 你的authtoken

啟動後

可見我的域名指向了127.0.0.1:8080。

（4）.將我們的域名填到公眾號中JS介面安全域名提交

提交之前我們需要將上圖中的紅色框框住的部分的檔案下載下來放置專案的static目錄下，測試存取通過之後，然後才能進行提交。

2.2、獲取code

可謂是一波三折呀，我本來以為我這個專案就要gg了。但也是我自己太小兒科了。微信怎麼可能沒有想到這麼一個問題呢。就是微信公眾號的 網頁授權獲取使用者基本資訊 功能服務。它這個功能服務必須只有 服務號 才擁有，但是其實每個使用者可以免註冊獲得一個測試號，該測試號就含有這個特殊功能服務。

（1）.登入自己的測試號

微信測試號是免註冊的，我們直接掃碼登入即可。

（2）.編寫對應的介面

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author ：小肖
 * @date ：Created in 2022/2/1 21:55
 */
@RestController
@RequestMapping("/weixin")
@Slf4j
public class WeixinController {

    @GetMapping("/auth")
    public void auth(@RequestParam("code") String code){
        log.info("進入了auth方法...");
        log.info("code = {}",code);
    }
}

（3）.在登入測試號之後進行網頁授權

授權的域名就是我們在natapp.cn上購買的域名，如果沒有進行授權的話那麼就會報出 10003 redirect_uri域名與後臺設定不一致 錯誤。

（4）.進行存取url進行測試

https://open.weixin.qq.com/connect/oauth2/authorize?appid=測試號的appid&redirect_uri=http://你的域名/sell/weixin/auth&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect

注意點

被測試的物件必須先關注對應的測試號且必須在微信使用者端進行存取。

（5）.測試結果

成功獲取了使用者的code資訊。

2.3、換取access_token

（1）.編寫的controller

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

/**
 * @author ：小肖
 * @date ：Created in 2022/2/1 21:55
 */
@RestController
@RequestMapping("/weixin")
@Slf4j
public class WeixinController {

    @GetMapping("/auth")
    public void auth(@RequestParam("code") String code){
        log.info("進入了auth方法...");
        log.info("code = {}",code);
        String url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=appid&secret=appsecret&code=" + code + "&grant_type=authorization_code";
        RestTemplate restTemplate = new RestTemplate();
        String response = restTemplate.getForObject(url, String.class);
    }
}

（2）.存取的url組成

https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

引數	是否必須	說明
appid	是	公眾號的唯一標識
secret	是	公眾號的appsecret
code	是	填寫第一步獲取的code引數
grant_type	是	填寫為authorization_code

（3）.存取的結果

{
  "access_token": "53_HK355v2MhOolNlGkaoUf4oDCkyX0WDollvsQNU5SvhsvmvF2S2VoqdPXuokfERI2oqFvQijVShq8aQzeQ9n01mGKSJn7q5rLAcYbTjm1H7k",
  "expires_in": 7200,
  "refresh_token": "53_C1us_G770mgzXjd-PuK329qB65lXiK483_qxUXjKudwWIdHkOz5ntwlByEgUQfMEy_-7tCCzcO4DoHaFbY0JurpZYD3Bys6DLs8ua8J_CjU",
  "openid": "你的openid",
  "scope": "snsapi_base"
}

3、使用第三方sdk

3.1、引入第三方依賴

        <!--微信公眾號開發需要引入的依賴-->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-mp</artifactId>
            <version>3.1.0</version>
        </dependency>

3.2、將微信公眾號設定寫入yaml檔案並引入類中

wechat:
  mpAppId: 你的微信測試號appId
  mpAppSecret: 你的微信測試號secret

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * @author ：小肖
 * @date ：Created in 2022/2/2 10:31
 */
@Component
@Data
@ConfigurationProperties(prefix = "wechat")
public class WechatAccountConfig {

    /**
     * 公眾號id
     */
    private String mpAppId;

    /**
     * 公眾號金鑰
     */
    private String mpAppSecret;

}

3.3、編寫設定類初始化設定wxMpService設定

import me.chanjar.weixin.mp.api.WxMpConfigStorage;
import me.chanjar.weixin.mp.api.WxMpInMemoryConfigStorage;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.api.impl.WxMpServiceImpl;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;

/**
 * @author ：小肖
 * @date ：Created in 2022/2/2 10:24
 */
@Component
public class WechatMpConfig {


    @Autowired
    private WechatAccountConfig wechatAccountConfig;

    @Autowired
    private WxMpInMemoryConfigStorage wxMpInMemoryConfigStorage;

    @Bean
    public WxMpService wxMpService(){
        WxMpService wxMpService = new WxMpServiceImpl();
        wxMpService.setWxMpConfigStorage(wxMpInMemoryConfigStorage);
        return wxMpService;
    }

    @Bean
    public WxMpInMemoryConfigStorage wxMpConfigStorage(){
        /**
         * 這裡需要注意的是 由於父類別中沒有定義對應的介面
         * 所以所有的方法都在其實現類中，所以我們要構造實現類
         */
        WxMpInMemoryConfigStorage wxMpConfigStorage = new WxMpInMemoryConfigStorage();
        wxMpConfigStorage.setAppId(wechatAccountConfig.getMpAppId());
        wxMpConfigStorage.setSecret(wechatAccountConfig.getMpAppSecret());
        return wxMpConfigStorage;
    }
}

3.4、編寫對應的controller

import com.xiao.enums.ResultEnum;
import com.xiao.exception.SellException;
import lombok.extern.slf4j.Slf4j;
import me.chanjar.weixin.common.api.WxConsts;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.result.WxMpOAuth2AccessToken;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author ：小肖
 * @date ：Created in 2022/2/2 10:20
 */
@Controller
@RequestMapping("/wechat")
@Slf4j
public class WechatController {

    @Autowired
    private WxMpService wxMpService;

    @GetMapping("/authorize")
    public String authorize(@RequestParam("returnUrl") String returnUrl){
        String url = "http://xiao-sell.natapp1.cc/sell/wechat/userInfo";
        String redirectUrl = wxMpService.oauth2buildAuthorizationUrl(url, WxConsts.OAuth2Scope.SNSAPI_USERINFO,returnUrl);
        return "redirect:" +  redirectUrl;
    }

    @GetMapping("/userInfo")
    public String userInfo(@RequestParam("code") String code,
                         @RequestParam("state") String returnUrl) {
        WxMpOAuth2AccessToken wxMpOAuth2AccessToken = new WxMpOAuth2AccessToken();
        try{
            wxMpOAuth2AccessToken = wxMpService.oauth2getAccessToken(code);
        }catch (WxErrorException e){
            log.error("【微信網頁授權錯誤】 exception = {}",e);
            throw new SellException(ResultEnum.WECHAT_MP_ERROR.getCode(),e.getError().getErrorMsg());
        }
        String openId = wxMpOAuth2AccessToken.getOpenId();
        log.info("openid = {}",openId);
        return "redirect:" + returnUrl + "?openid=" + openId;
    }
}