Java微信授權(quán)登陸的實現(xiàn)示例

更新時間：2021年06月04日 13:01:31 作者：JavaManual

微信授權(quán)登錄，官方文檔寫的比較簡潔。所以對于會的人一目了然，而對于新手剛?cè)腴T的人來說是舉步維艱。本文詳細(xì)的介紹了Java微信授權(quán)登陸的實現(xiàn)示例，感興趣的朋友可以了解一下

前提：

微信公眾平臺：注冊微信認(rèn)證的公眾號也就是服務(wù)號，擁有跟高級權(quán)限的微信接口。（注冊服務(wù)號需要一些企業(yè)信息，需自己或者公司解決）

注： 2018年12月起訂閱號不能認(rèn)證升級為服務(wù)號。但可以將你的訂閱號遷移至另一個公眾號，需300元費用。

準(zhǔn)備公眾號的：APPID 與 APPSECRET

二、服務(wù)號注冊成功后，如果項目也有服務(wù)號的公眾號平臺，跟項目負(fù)責(zé)人溝通將你個人的微信號添加為服務(wù)號的管理

找到左邊導(dǎo)航欄最下面的基本配置進(jìn)去，記住公眾號的 AppId 與 AppSevrect ，如果AppServret忘記了重置重新記住。

配置IP白名單，項目所處的IP配置進(jìn)去，如拿自己的本機(jī)ip用于臨時的配置上去，等項目上線重新配置IP。

然后微信登陸需要微信網(wǎng)頁授權(quán)，在公眾中網(wǎng)頁授權(quán)需要配置一個域名，準(zhǔn)備一個備案的域名，域名備案好大概需要20個工作日，如果沒有可以下載花生殼軟件新手注冊會送一個免費域名可以用來做測試，如果有備案好的域名當(dāng)然更好。

沒有備案的域名情況，用花生殼內(nèi)網(wǎng)穿透測試

自己注冊會送個免費的域名然后花6塊永久的內(nèi)網(wǎng)穿透體驗版注冊好后，內(nèi)網(wǎng)穿透配置

配置好后可以診斷測試，確保配置的端口在運(yùn)行中，如果是項目的端口項目要處于運(yùn)行中狀態(tài)，不然會連接失敗

這些都沒問題后回到在公眾號內(nèi)的左邊導(dǎo)航找到公眾號設(shè)置 ----- 功能設(shè)置 --- 網(wǎng)頁授權(quán)域名進(jìn)行域名授權(quán)配置。

一、域名授權(quán)需要你下載一個文件放置你的域名根目錄下，也就就是你域名訪問的項目的根目錄下，然后在通過瀏覽器域名/文件名.txt 可以訪問到文件中的內(nèi)容，這個是重點，一定要可以訪問的到文件內(nèi)容，然后在去網(wǎng)頁授權(quán)域名綁定域名保存就好。配置以后此域名下面的頁面http://www.qq.com/music.html 、 http://www.qq.com/login.html 都可以進(jìn)行OAuth2.0鑒權(quán)。但http://pay.qq.com 、 http://music.qq.com 、 http://qq.com無法進(jìn)行OAuth2.0鑒權(quán)

如果公眾號登錄授權(quán)給了第三方開發(fā)者來進(jìn)行管理，則不必做任何設(shè)置，由第三方代替公眾號實現(xiàn)網(wǎng)頁授權(quán)即可

二、記住是域名，不是URL。不需要帶http。

文件放置項目的根目錄或者webapp下，可以通過瀏覽器域名/文件名.txt 訪問文件內(nèi)容，也可放置項目的目錄下，訪問時域名/目錄名/文件名

這里你可能會遇見配置失敗報找不到這個文件或時文件內(nèi)容不匹配

注意看你是否放置根目錄下，位置沒錯。項目是否有攔截器攔截了導(dǎo)致訪問不到該文件

以上都都弄好了開始我們重點編碼。

微信授權(quán)登陸流程：

登陸授權(quán)作用域分為兩種：

一、靜默登陸 scope參數(shù)值為 snsapi_base；只能獲取到用戶openid。好處是靜默認(rèn)證，無需用戶手動點擊認(rèn)證按鈕，感覺上像是直接進(jìn)入網(wǎng)站一樣。

二、授權(quán)登陸 scope參數(shù)值為 snsapi_userinfo；可以獲取到openid、昵稱、頭像、所在地等信息。需要用戶手動點擊認(rèn)證按鈕

授權(quán)登陸步驟：

1、引導(dǎo)用戶進(jìn)入授權(quán)頁面同意授權(quán)，獲取code

2、通過code換取網(wǎng)頁授權(quán)access_token（與基礎(chǔ)支持中的access_token不同）和openid

3、通過網(wǎng)頁授權(quán)access_token和openid獲取用戶基本信息

一、微信登陸觸發(fā)按鈕或圖片鏈接

在首頁準(zhǔn)備一個按鈕或者一個鏈接用來發(fā)起請求。

這里我們用一個鏈接做示例

1.通過微信接口獲取code

微信獲取code接口： https://open.weixin.qq.com/connect/oauth2/authorize?

參數(shù)下表：

參數(shù)	是否必須	說明
appid	是	公眾號的唯一標(biāo)識
redirect_uri	是	授權(quán)后重定向的回調(diào)鏈接地址，請使用urlencode對鏈接進(jìn)行處理
response_type	是	返回類型，請?zhí)顚慶ode
scope	是	應(yīng)用授權(quán)作用域，snsapi_base （不彈出授權(quán)頁面，直接跳轉(zhuǎn)，只能獲取用戶openid），snsapi_userinfo （彈出授權(quán)頁面，可通過openid拿到昵稱、性別、所在地。并且，即使在未關(guān)注的情況下，只要用戶授權(quán)，也能獲取其信息）
state	否	重定向后會帶上state參數(shù)，開發(fā)者可以填寫a-zA-Z0-9的參數(shù)值，最多128字節(jié)
#wechat_redirect	是	無論直接打開還是做頁面302重定向時候，必須帶此參數(shù)

code作為換取access_token的票據(jù)，每次用戶授權(quán)帶上的code將不一樣，code只能使用一次，5分鐘未被使用自動過期。

Controller控制器：

微信用戶授權(quán)確認(rèn)登陸

第一步登錄鏈接拼好后，在手機(jī)微信中打開，微信便會跳轉(zhuǎn)到確認(rèn)授權(quán)頁面，點擊確認(rèn)授權(quán)即可。（這一步，不用開發(fā)者做處理?。?/li>
用戶同意授權(quán)，頁面將跳轉(zhuǎn)至 redirect_uri/?code=CODE&state=STATE。

二、獲取 openid

請求與帶攜帶參數(shù)