微信公眾號掃碼登錄功能實(shí)現(xiàn)：Java后端集成指南

大家好，我是 V哥。掃碼登錄是個(gè)很普遍的功能，通過與公眾號聯(lián)動(dòng)實(shí)現(xiàn)掃碼登錄功能，要怎么做呢，V 哥整理了以下步驟和代碼，供你參考。這里假設(shè)你已經(jīng)有一個(gè)Java后端應(yīng)用，并且微信開發(fā)者平臺(tái)的配置也已經(jīng)完成。（相信你可以根據(jù)微信開放平臺(tái)的操作進(jìn)行）整個(gè)流程包括二維碼生成、掃碼后獲取微信用戶信息、并將用戶登錄狀態(tài)返回到你的應(yīng)用中。

1. 微信公眾號掃碼登錄流程

1. 申請掃碼登錄權(quán)限：在微信開放平臺(tái)申請掃碼登錄權(quán)限。
2. 生成二維碼：使用微信提供的接口生成一個(gè)包含應(yīng)用授權(quán)信息的二維碼。
3. 用戶掃碼授權(quán)：用戶掃描二維碼，授權(quán)登錄。
4. 獲取授權(quán)碼：用戶授權(quán)后，微信會(huì)回調(diào)給開發(fā)者一個(gè)授權(quán)碼。
5. 獲取用戶信息：使用授權(quán)碼獲取用戶的基本信息（如昵稱、頭像等）。
6. 建立會(huì)話：將用戶信息與系統(tǒng)的會(huì)話綁定，完成登錄流程。

2. 前置準(zhǔn)備

確保你在微信開放平臺(tái)上配置了以下信息：

• AppID 和 AppSecret：在“公眾號設(shè)置”頁面可以找到。
• 授權(quán)回調(diào)域名：在開放平臺(tái)進(jìn)行授權(quán)配置。

3. Java 實(shí)現(xiàn)掃碼登錄

使用Spring Boot實(shí)現(xiàn)一個(gè)簡單的微信掃碼登錄后端接口：

導(dǎo)入依賴

在 pom.xml 中添加必要的依賴項(xiàng)：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

代碼實(shí)現(xiàn)

1. 配置微信相關(guān)信息：

   @Configuration
   public class WeChatConfig {
       @Value("${wechat.appId}")
       private String appId;
       
       @Value("${wechat.appSecret}")
       private String appSecret;
       
       @Value("${wechat.redirectUri}")
       private String redirectUri;
       
       public String getAppId() {
           return appId;
       }
       public String getAppSecret() {
           return appSecret;
       }
       public String getRedirectUri() {
           return redirectUri;
       }
   }

1. 生成二維碼：

創(chuàng)建一個(gè)控制器來生成微信掃碼二維碼URL。

   @RestController
   @RequestMapping("/api/wechat")
   public class WeChatLoginController {
       @Autowired
       private WeChatConfig weChatConfig;
       @GetMapping("/login/qrcode")
       public ResponseEntity<String> getQRCode() {
           String url = "https://open.weixin.qq.com/connect/qrconnect" +
                   "?appid=" + weChatConfig.getAppId() +
                   "&redirect_uri=" + URLEncoder.encode(weChatConfig.getRedirectUri(), StandardCharsets.UTF_8) +
                   "&response_type=code" +
                   "&scope=snsapi_login" +
                   "&state=STATE#wechat_redirect";
           return ResponseEntity.ok(url);
       }
   }

通過此接口可以生成微信掃碼登錄的二維碼URL。

1. 回調(diào)接口：

微信掃碼后會(huì)將用戶重定向到配置的回調(diào)URL，在回調(diào)中處理授權(quán)碼并獲取用戶信息。

   @GetMapping("/callback")
   public ResponseEntity<String> weChatCallback(@RequestParam("code") String code) {
       String accessTokenUrl = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=" + weChatConfig.getAppId() +
               "&secret=" + weChatConfig.getAppSecret() +
               "&code=" + code +
               "&grant_type=authorization_code";
       RestTemplate restTemplate = new RestTemplate();
       String response = restTemplate.getForObject(accessTokenUrl, String.class);
       JSONObject json = new JSONObject(response);
       String accessToken = json.getString("access_token");
       String openId = json.getString("openid");
       // 獲取用戶信息
       String userInfoUrl = "https://api.weixin.qq.com/sns/userinfo?access_token=" + accessToken + "&openid=" + openId;
       String userInfoResponse = restTemplate.getForObject(userInfoUrl, String.class);
       // 返回或保存用戶信息
       return ResponseEntity.ok(userInfoResponse);
   }

1. 會(huì)話管理與重定向：

在獲取到用戶信息后，可以將用戶數(shù)據(jù)存入Redis（或數(shù)據(jù)庫），并生成一個(gè)登錄態(tài)。

   @Autowired
   private RedisTemplate<String, Object> redisTemplate;
   @PostMapping("/saveSession")
   public ResponseEntity<String> saveSession(@RequestBody Map<String, String> userInfo) {
       String sessionId = UUID.randomUUID().toString();
       redisTemplate.opsForValue().set(sessionId, userInfo);
       // 返回Session ID作為登錄憑證
       return ResponseEntity.ok(sessionId);
   }

4. 前端處理

在前端頁面中調(diào)用 /api/wechat/login/qrcode 接口，將二維碼顯示給用戶。當(dāng)用戶掃碼并完成授權(quán)后，前端可以獲取后端傳回的Session ID，表示登錄成功。

完整流程小結(jié)

1. 訪問后端接口生成二維碼鏈接。
2. 前端顯示二維碼，用戶掃碼后進(jìn)入微信授權(quán)頁面。
3. 授權(quán)成功后，微信重定向至后端的 /callback。
4. 后端使用 code 獲取用戶信息，并保存會(huì)話信息（如Redis）。
5. 返回前端Session ID作為登錄憑證。

使用以上代碼和步驟可以實(shí)現(xiàn)完整的微信公眾號掃碼登錄流程，前端就可以使用得到的Session ID來維護(hù)用戶登錄狀態(tài)啦。

由于演示案例涉及自己的賬號信息和微信開放平臺(tái)的私密信息，請根據(jù)自己的情況使用代碼案例，下課。微信掃碼登錄, Java后端實(shí)現(xiàn), Spring Boot, 微信公眾號, 微信開放平臺(tái), 二維碼生成, 用戶授權(quán), 會(huì)話管理