SpringBoot中如何獲取微信用戶信息

這篇文章將為大家詳細(xì)講解有關(guān)SpringBoot中如何獲取微信用戶信息，小編覺得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

獲取公眾號(hào)用戶信息實(shí)戰(zhàn)

第一步需要先申請(qǐng)接口測(cè)試號(hào)并進(jìn)行網(wǎng)頁(yè)授權(quán)設(shè)置

訪問如下鏈接進(jìn)行接口測(cè)試號(hào)申請(qǐng)。

https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Requesting_an_API_Test_Account.html

選擇接口測(cè)試號(hào)申請(qǐng)，如下圖所示：

點(diǎn)擊登錄進(jìn)行掃碼登錄，如下圖所示：

登錄后如下圖所示：

在下面的的網(wǎng)頁(yè)賬號(hào)一欄添加網(wǎng)頁(yè)授權(quán)的IP或者域名。

為了方便測(cè)試我這里設(shè)置成了回環(huán)地址，最好設(shè)置成具體的 IP 地址或者域名信息。域名和 IP 地址不要添加http或者h(yuǎn)ttps。這里 IP 和域名可以是內(nèi)網(wǎng)地址。

到這里網(wǎng)頁(yè)授權(quán)設(shè)置完畢！

第二步是下載微信web開發(fā)者工具，可以在PC 進(jìn)行測(cè)試。

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Web_Developer_Tools.html

傻瓜式一步一步安裝即可。

第三步 看微信操作教程并完成代碼實(shí)現(xiàn)

接下來就是代碼部分編寫了，在開發(fā)前首先需要看一下獲取微信公眾號(hào)用戶信息的教程：
通過訪問：https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html。獲取微信用戶信息具體操作有如下4步。

第一步：用戶同意授權(quán)，獲取code

代碼的操作就是拼接引導(dǎo)用戶進(jìn)行微信授權(quán)地址，然后重定向到微信服務(wù)，微信服務(wù)在根據(jù)重定向的 URL 地址并攜帶 code 重定向到我們的服務(wù)器。這一步需要配置有公眾號(hào) appid 和 redirect_uri 。

需要注意的是重定向的地址需要 encode 以下，具體操作如下面代碼所示：

String url = URLEncoder.encode(request.getRequestURL().toString());

具體地址如下圖所示：紅色框位置需要改為我們公眾號(hào) appid 和 redirect_uri 信息，其他的內(nèi)容不用改動(dòng)。

程序重定向該地址后會(huì)讓用戶進(jìn)行授權(quán)，如下圖所示：

用戶點(diǎn)擊同意后，微信服務(wù)會(huì)根據(jù)重定向地址重定向回我們的服務(wù)中并攜帶code。

第二步就是根據(jù) code 獲取網(wǎng)頁(yè)授權(quán) access_token 和 openid。

調(diào)用如下面所示微信 API ，紅色框 code 替換成獲取的 code，其他內(nèi)容不用做任何改動(dòng)。

第三步：刷新access_token（如果需要）

access_token有效期是7200s，當(dāng)access_token超時(shí)后，可以使用refresh_token進(jìn)行刷新，refresh_token有效期為30天，當(dāng)refresh_token失效之后，需要用戶重新授權(quán)。這步可做可不做，我們這里就繞開這步。

第四步：拉取用戶信息(需scope為 snsapi_userinfo)

關(guān)于網(wǎng)頁(yè)授權(quán)的兩種scope的區(qū)別說明

1、以snsapi_base為scope發(fā)起的網(wǎng)頁(yè)授權(quán)，是用來獲取進(jìn)入頁(yè)面的用戶的openid的，并且是靜默授權(quán)并自動(dòng)跳轉(zhuǎn)到回調(diào)頁(yè)的。用戶感知的就是直接進(jìn)入了回調(diào)頁(yè)（往往是業(yè)務(wù)頁(yè)面）

2、以snsapi_userinfo為scope發(fā)起的網(wǎng)頁(yè)授權(quán)，是用來獲取用戶的基本信息的。但這種授權(quán)需要用戶手動(dòng)同意，并且由于用戶同意過，所以無(wú)須關(guān)注，就可在授權(quán)后獲取該用戶的基本信息。

根據(jù)第二步獲取的 access_token 和 opendId 獲取微信用戶的信息。調(diào)用如下圖所示微信 API，將獲取的 access_token 和 opendId 替換如下圖中紅色框位置內(nèi)容，其他不用做任何改動(dòng)。返回的 json 信息就是該公眾好號(hào)的用戶信息。

講完操作流程，接下來就是代碼實(shí)現(xiàn)。具體獲取微信用戶信息 Controller 內(nèi)容如下：

@RestController
@RequestMapping("/weixin")
public class WeiXinDemoController {
  @Autowired
  private WeiXinService weiXinService;

  @RequestMapping("/getWeiXinUserInfo")
  public String getWeiXinUserInfo(String code,HttpServletRequest request,HttpServletResponse response,HttpSession session) throws IOException{
    //第一步：用戶同意授權(quán)，獲取code
    if (code == null) {
      String url = URLEncoder.encode(request.getRequestURL().toString());
      String authorizeUrl = weiXinService.buildAuthorizeURL(url);
      response.sendRedirect(authorizeUrl);
      return null;
    }
    //第二步：通過code換取網(wǎng)頁(yè)授權(quán)access_token和openid
    String htmlInfo = "";
    Map<String, Object> openIdInfo = weiXinService.getOpenIdInfo(code);
    String errcode = (String)openIdInfo.get("errcode");
    if(StringUtils.isEmpty(errcode)){
      //第四步：拉取用戶信息(需scope為 snsapi_userinfo)根據(jù)access_token和OpenId
      Map<String, Object> weiXinUserInfo = weiXinService.getWeiXinUserInfo(openIdInfo);
      String userInfohtml = createUserInfoHtml(weiXinUserInfo);
      return userInfohtml;
    }
    return htmlInfo;
  }

@Component
@ConfigurationProperties(prefix="wx")
public class WeiXinConfig {
  
  private String appID;
  private String mchID;
  private String appsecret;
  private String key;
  
  //省略getter and setter
}

application.properties 配置內(nèi)容如下：

微信核心處理都在 WeiXinService中，微信接口調(diào)用時(shí)通過 RestTemplate來實(shí)現(xiàn)的。

拼接引導(dǎo)用戶進(jìn)行微信授權(quán)地址代碼如下：

  /**
   * 拼接用戶授權(quán)重定向的URL
   * @param url
   * @return
   */
  public String buildAuthorizeURL(String url){
    
    return concatAuthorizeURL(url);
  }
    private String concatAuthorizeURL(String url) {
    StringBuilder authorizeUrl = new StringBuilder(AUTHORIZEURL);
    authorizeUrl.append("?appid=").append(weiXinConfig.getAppID());
    authorizeUrl.append("&redirect_uri=").append(url);
    authorizeUrl.append("&response_type=code");
     //snsapi_base （不彈出授權(quán)頁(yè)面，直接跳轉(zhuǎn)，只能獲取用戶openid），
     //snsapi_userinfo （彈出授權(quán)頁(yè)面，可通過openid拿到昵稱、性別、所在地。并且， 即使在未關(guān)注的情況下，只要用戶授權(quán)，也能獲取其信息 ）
    authorizeUrl.append("&scope=snsapi_userinfo");
    authorizeUrl.append("&state=").append("STATE");
    authorizeUrl.append("#wechat_redirect");
    return authorizeUrl.toString();
  }

根據(jù) code 獲取網(wǎng)頁(yè)授權(quán) access_token 和 openid 代碼如下：

  /**
   * 獲取 access_token 和 openid
   * @param code
   * @return
   */
  public Map<String,Object> getOpenIdInfo(String code){
    
    String getAccessTokenUrl = concatGetOpenIdInfoURL(code);
    String json = postRequestForWechat(getAccessTokenUrl);
    Map<String,Object> map = jsonToMap(json);
    
    return map;
  }
  private String concatGetOpenIdInfoURL(String code) {
    StringBuilder getAccessTokenUrl = new StringBuilder(GE_TACCESSTOKEN_URL);
    getAccessTokenUrl.append("?appid=").append(weiXinConfig.getAppID());
    getAccessTokenUrl.append("&secret=").append(weiXinConfig.getAppsecret());
    getAccessTokenUrl.append("&code=").append(code);
    getAccessTokenUrl.append("&grant_type=authorization_code");
    return getAccessTokenUrl.toString();
  }
  private String postRequestForWechat(String getAccessTokenUrl) {
    ResponseEntity<String> postForEntity = restTemplate.postForEntity(getAccessTokenUrl, null, String.class);
    String json = postForEntity.getBody();
    return json;
  }
    private Map jsonToMap(String json) {
    Gson gons = new Gson();
    Map map = gons.fromJson(json, new TypeToken<Map>(){}.getType());
    return map;
  }

通過 access_token 和 openid 獲取微信用戶信息 代碼如下：

  /**
   * 獲取微信用戶信息通過 access_token 和 openid
   * @param map
   * @return
   */
  public Map getWeiXinUserInfo(Map<String, Object> map) {
    
    String getUserInfoUrl = concatGetWeiXinUserInfoURL(map);
    String json = getRequestForWechat(getUserInfoUrl);
    Map userInfoMap = jsonToMap(json);
    
    return userInfoMap;
  }
    private String concatGetWeiXinUserInfoURL(Map<String, Object> map) {
    String openId = (String) map.get("openid");
    String access_token = (String) map.get("access_token");
    // 繞過檢驗(yàn)授權(quán)憑證（access_token）是否有效
    StringBuilder getUserInfoUrl = new StringBuilder(GE_USERINFO_URL);
    getUserInfoUrl.append("?access_token=").append(access_token);
    getUserInfoUrl.append("&openId=").append(openId);
    getUserInfoUrl.append("&lang=zh_CN");
    
    return getUserInfoUrl.toString();
  }
  private String getRequestForWechat(String getUserInfoUrl) {
    ResponseEntity<String> postForEntity = restTemplate.getForEntity(getUserInfoUrl.toString(), String.class);
    String json = postForEntity.getBody();
    return json;
  }

測(cè)試

下載微信web開發(fā)者工具完成后，根據(jù)傻瓜式安裝即可。安裝完成后打開web開發(fā)者工具，如下圖所示選擇公眾號(hào)網(wǎng)頁(yè)。

輸入 http:127.0.1:8090/sbe2/weixin/getWeiXinUserInfo，就會(huì)看到該測(cè)試公眾號(hào)的用戶信息。

一般情況下我們通過接口測(cè)試號(hào)配置成測(cè)試環(huán)境域名或 IP，測(cè)試通過后就可以在服務(wù)號(hào)上配置網(wǎng)頁(yè)授權(quán)域名，順便在把我們項(xiàng)目配置的 appid 換成服務(wù)號(hào)的 appid 即可。具體操作如下：

小結(jié)

獲取微信公眾號(hào)用戶信息步驟就是：第一步拼接引導(dǎo)用戶授權(quán)的地址然后根據(jù)該地址重定向到微信服務(wù)，第二步獲取授權(quán)code，根據(jù) code 獲取 access_token 和 OpenId，第三步根據(jù) access_token 和 OpenId 獲取微信用戶信息。

我這里介紹最簡(jiǎn)三步，正常來講還需要驗(yàn)證access_token 是否有效，這一步也可以通過緩存access_token到Reid中并設(shè)置過期時(shí)間，當(dāng)其失效后刷新access_token。

在這里再三強(qiáng)調(diào)一下，微信提供操作文檔一定要多看幾篇，因?yàn)楹芏嗉?xì)節(jié)都在文檔中進(jìn)行了說明。當(dāng)你把微信提供操作文檔看透，你就會(huì)覺得其實(shí)就是個(gè)API 調(diào)用而已。

springboot是什么

springboot一種全新的編程規(guī)范，其設(shè)計(jì)目的是用來簡(jiǎn)化新Spring應(yīng)用的初始搭建以及開發(fā)過程，SpringBoot也是一個(gè)服務(wù)于框架的框架，服務(wù)范圍是簡(jiǎn)化配置文件。

關(guān)于“SpringBoot中如何獲取微信用戶信息”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺得文章不錯(cuò)，請(qǐng)把它分享出去讓更多的人看到。