Spring Boot獲取微信用戶(hù)信息的超簡(jiǎn)單方法
前言
不知道你是否參加過(guò)拼多多上邀請(qǐng)微信好友砍價(jià)功能,這個(gè)功能實(shí)現(xiàn)首先需要考慮的就是獲取微信用戶(hù)的信息。獲取用戶(hù)信息就是獲取公眾號(hào)下微信用戶(hù)的信息,今天我就來(lái)講講如何從公眾號(hào)下獲取微信用戶(hù)信息。
需要聲明一點(diǎn)的是獲取微信公眾號(hào)下的用戶(hù)信息的權(quán)限是服務(wù)號(hào)才有,個(gè)人訂閱號(hào)是沒(méi)有該權(quán)限的。
獲取公眾號(hào)用戶(hù)信息實(shí)戰(zhàn)
第一步需要先申請(qǐng)接口測(cè)試號(hào)并進(jìn)行網(wǎng)頁(yè)授權(quán)設(shè)置
訪問(wèn)如下鏈接進(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開(kāi)發(fā)者工具,可以在PC 進(jìn)行測(cè)試。
https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Web_Developer_Tools.html

傻瓜式一步一步安裝即可。
第三步 看微信操作教程并完成代碼實(shí)現(xiàn)
接下來(lái)就是代碼部分編寫(xiě)了,在開(kāi)發(fā)前首先需要看一下獲取微信公眾號(hào)用戶(hù)信息的教程:
通過(guò)訪問(wèn):https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html 。獲取微信用戶(hù)信息具體操作有如下4步。

第一步:用戶(hù)同意授權(quán),獲取code
代碼的操作就是拼接引導(dǎo)用戶(hù)進(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ì)讓用戶(hù)進(jìn)行授權(quán),如下圖所示:

用戶(hù)點(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失效之后,需要用戶(hù)重新授權(quán)。這步可做可不做,我們這里就繞開(kāi)這步。
第四步:拉取用戶(hù)信息(需scope為 snsapi_userinfo)
關(guān)于網(wǎng)頁(yè)授權(quán)的兩種scope的區(qū)別說(shuō)明
1、以snsapi_base為scope發(fā)起的網(wǎng)頁(yè)授權(quán),是用來(lái)獲取進(jìn)入頁(yè)面的用戶(hù)的openid的,并且是靜默授權(quán)并自動(dòng)跳轉(zhuǎn)到回調(diào)頁(yè)的。用戶(hù)感知的就是直接進(jìn)入了回調(diào)頁(yè)(往往是業(yè)務(wù)頁(yè)面)
2、以snsapi_userinfo為scope發(fā)起的網(wǎng)頁(yè)授權(quán),是用來(lái)獲取用戶(hù)的基本信息的。但這種授權(quán)需要用戶(hù)手動(dòng)同意,并且由于用戶(hù)同意過(guò),所以無(wú)須關(guān)注,就可在授權(quán)后獲取該用戶(hù)的基本信息。
根據(jù)第二步獲取的 access_token 和 opendId 獲取微信用戶(hù)的信息。調(diào)用如下圖所示微信 API,將獲取的 access_token 和 opendId 替換如下圖中紅色框位置內(nèi)容,其他不用做任何改動(dòng)。返回的 json 信息就是該公眾好號(hào)的用戶(hù)信息。

講完操作流程,接下來(lái)就是代碼實(shí)現(xiàn)。具體獲取微信用戶(hù)信息 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{
//第一步:用戶(hù)同意授權(quán),獲取code
if (code == null) {
String url = URLEncoder.encode(request.getRequestURL().toString());
String authorizeUrl = weiXinService.buildAuthorizeURL(url);
response.sendRedirect(authorizeUrl);
return null;
}
//第二步:通過(guò)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)){
//第四步:拉取用戶(hù)信息(需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í)通過(guò) RestTemplate來(lái)實(shí)現(xiàn)的。
拼接引導(dǎo)用戶(hù)進(jìn)行微信授權(quán)地址代碼如下:
/**
* 拼接用戶(hù)授權(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),只能獲取用戶(hù)openid),
//snsapi_userinfo (彈出授權(quán)頁(yè)面,可通過(guò)openid拿到昵稱(chēng)、性別、所在地。并且, 即使在未關(guān)注的情況下,只要用戶(hù)授權(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;
}
通過(guò) access_token 和 openid 獲取微信用戶(hù)信息 代碼如下:
/**
* 獲取微信用戶(hù)信息通過(guò) 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");
// 繞過(guò)檢驗(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開(kāi)發(fā)者工具完成后,根據(jù)傻瓜式安裝即可。安裝完成后打開(kāi)web開(kāi)發(fā)者工具,如下圖所示選擇公眾號(hào)網(wǎng)頁(yè)。

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

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


小結(jié)
獲取微信公眾號(hào)用戶(hù)信息步驟就是:第一步拼接引導(dǎo)用戶(hù)授權(quán)的地址然后根據(jù)該地址重定向到微信服務(wù),第二步獲取授權(quán)code,根據(jù) code 獲取 access_token 和 OpenId,第三步根據(jù) access_token 和 OpenId 獲取微信用戶(hù)信息。
我這里介紹最簡(jiǎn)三步,正常來(lái)講還需要驗(yàn)證access_token 是否有效,這一步也可以通過(guò)緩存access_token到Reid中并設(shè)置過(guò)期時(shí)間,當(dāng)其失效后刷新access_token。
在這里再三強(qiáng)調(diào)一下,微信提供操作文檔一定要多看幾篇,因?yàn)楹芏嗉?xì)節(jié)都在文檔中進(jìn)行了說(shuō)明。當(dāng)你把微信提供操作文檔看透,你就會(huì)覺(jué)得其實(shí)就是個(gè)API 調(diào)用而已。
代碼示例
具體代碼示例請(qǐng)查看我的GitHub 倉(cāng)庫(kù) springbootexamples 中的 spring-boot-2.x-weixin 查看。
GitHub:https://github.com/zhuoqianmingyue/springbootexamples
總結(jié)
以上就是這篇文章的全部?jī)?nèi)容了,希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,謝謝大家對(duì)腳本之家的支持。
- springboot整合微信支付sdk過(guò)程解析
- springboot 微信授權(quán)網(wǎng)頁(yè)登錄操作流程
- SpringBoot 微信退款功能的示例代碼
- Springboot單體架構(gòu)http請(qǐng)求轉(zhuǎn)換https請(qǐng)求來(lái)支持微信小程序調(diào)用接口
- 基于springboot微信公眾號(hào)開(kāi)發(fā)(微信自動(dòng)回復(fù))
- SpringBoot JS-SDK自定義微信分享的實(shí)現(xiàn)
- 微信小程序 springboot后臺(tái)如何獲取用戶(hù)的openid
- SpringBoot中獲取微信用戶(hù)信息的方法
- SpringBoot微信消息接口配置詳解
- activemq整合springboot使用方法(個(gè)人微信小程序用)
- Springboot網(wǎng)站第三方登錄 微信登錄
- Spring Boot項(xiàng)目中集成微信支付v3
相關(guān)文章
SpringBoot中啟動(dòng)時(shí)如何忽略某項(xiàng)檢測(cè)
這篇文章主要介紹了SpringBoot中啟動(dòng)時(shí)如何忽略某項(xiàng)檢測(cè),具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-11-11
Java編程細(xì)節(jié)重構(gòu)之為什么if-else不是好代碼詳析
這篇文章主要給大家介紹了關(guān)于Java編程細(xì)節(jié)重構(gòu)之為什么if-else不是好代碼的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)些學(xué)習(xí)吧2018-09-09
Spring實(shí)戰(zhàn)之FileSystemResource加載資源文件示例
這篇文章主要介紹了Spring實(shí)戰(zhàn)之FileSystemResource加載資源文件,結(jié)合實(shí)例形式分析了spring FileSystemResource加載xml資源文件的具體實(shí)現(xiàn)步驟與相關(guān)操作技巧,需要的朋友可以參考下2019-12-12
Spring Validation和Hibernate Validator結(jié)合國(guó)際化代碼實(shí)例
這篇文章主要介紹了Spring Validation和Hibernate Validator結(jié)合國(guó)際化代碼實(shí)例,我們需要對(duì)請(qǐng)求參數(shù)進(jìn)行非空、長(zhǎng)度、正確性進(jìn)行校驗(yàn), 本文主要講解Spring Validation 和 Hibernate Validator, 同時(shí)整合i18n(國(guó)際化)實(shí)現(xiàn)參數(shù)校驗(yàn)自動(dòng),需要的朋友可以參考下2023-10-10
spring如何集成cxf實(shí)現(xiàn)webservice接口功能詳解
這篇文章主要給大家介紹了關(guān)于spring如何集成cxf實(shí)現(xiàn)webservice接口功能的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家 的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面來(lái)一起看看吧2018-07-07
淺談Java如何實(shí)現(xiàn)一個(gè)基于LRU時(shí)間復(fù)雜度為O(1)的緩存
這篇文章主要介紹了淺談Java如何實(shí)現(xiàn)一個(gè)基于LRU時(shí)間復(fù)雜度為O(1)的緩存,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-08-08

