快捷導(dǎo)航

SpringBoot實現(xiàn)微信掃碼登錄的示例代碼

更新時間：2025年04月25日 10:07:31 作者：灰_灰丶灰

本文主要介紹了SpringBoot實現(xiàn)微信掃碼登錄的示例代碼,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

1. 注冊和配置

注冊微信賬號：首先在微信注冊一個賬號。
獲取應(yīng)用的 AppID 和 AppSecret：在微信上創(chuàng)建應(yīng)用后，你會得到 AppID 和 AppSecret，這兩個值在后續(xù)步驟中會用到。
配置授權(quán)回調(diào)域：在微信設(shè)置中，配置授權(quán)回調(diào)域名。這個域名是微信在用戶授權(quán)后回調(diào)的地址，例如 yourdomain.com。

2. 前端代碼準(zhǔn)備

在前端頁面上添加一個按鈕或鏈接，讓用戶點(diǎn)擊后開始微信掃碼登錄流程。

<a href="/wechat/login" rel="external nofollow" >微信登錄</a>

3. 后端代碼實現(xiàn)

3.1 配置項目

首先，在 application.properties 文件中添加微信應(yīng)用的配置：

wechat.app-id=YOUR_APP_ID
wechat.app-secret=YOUR_APP_SECRET
wechat.redirect-uri=http://yourdomain.com/wechat/callback

3.2 創(chuàng)建微信掃碼登錄控制器

package com.example.demo.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.client.RestTemplate;

import java.util.UUID;

@Controller
public class WeChatLoginController {

    @Value("${wechat.app-id}")
    private String appId;

    @Value("${wechat.app-secret}")
    private String appSecret;

    @Value("${wechat.redirect-uri}")
    private String redirectUri;

    @GetMapping("/wechat/login")
    public String wechatLogin() {
        String state = UUID.randomUUID().toString();
        String wechatUrl = "https://open.weixin.qq.com/connect/qrconnect?appid=" + appId
                + "&redirect_uri=" + redirectUri
                + "&response_type=code&scope=snsapi_login&state=" + state;
        return "redirect:" + wechatUrl;
    }

    @GetMapping("/wechat/callback")
    public String wechatCallback(String code, String state, Model model) {
        String tokenUrl = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=" + appId
                + "&secret=" + appSecret
                + "&code=" + code
                + "&grant_type=authorization_code";

        RestTemplate restTemplate = new RestTemplate();
        WeChatAccessTokenResponse response = restTemplate.getForObject(tokenUrl, WeChatAccessTokenResponse.class);

        if (response != null) {
            String userInfoUrl = "https://api.weixin.qq.com/sns/userinfo?access_token=" + response.getAccessToken()
                    + "&openid=" + response.getOpenId();
            WeChatUserInfo userInfo = restTemplate.getForObject(userInfoUrl, WeChatUserInfo.class);
            model.addAttribute("user", userInfo);
            return "userProfile";
        }

        return "error";
    }

    static class WeChatAccessTokenResponse {
        private String accessToken;
        private String openId;

        // Getters and setters
    }

    static class WeChatUserInfo {
        private String openId;
        private String nickname;
        private String sex;
        private String province;
        private String city;
        private String country;
        private String headimgurl;

        // Getters and setters
    }
}

3.3 創(chuàng)建用戶信息展示頁面

在 src/main/resources/templates 目錄下創(chuàng)建 userProfile.html 文件，用于顯示用戶信息：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>User Profile</title>
</head>
<body>
<h1>User Profile</h1>
<div>
    <img th:src="${user.headimgurl}" alt="User Avatar"/>
    <p>Nickname: <span th:text="${user.nickname}"></span></p>
    <p>Country: <span th:text="${user.country}"></span></p>
    <p>Province: <span th:text="${user.province}"></span></p>
    <p>City: <span th:text="${user.city}"></span></p>
</div>
</body>
</html>

4. 執(zhí)行流程

用戶點(diǎn)擊微信登錄鏈接：用戶點(diǎn)擊前端頁面上的微信登錄鏈接，瀏覽器會重定向到微信的授權(quán)頁面。
用戶掃碼并授權(quán)：用戶在微信授權(quán)頁面掃碼并授權(quán)，微信會將授權(quán)結(jié)果（包含授權(quán)碼 code）回調(diào)到你配置的回調(diào)URL。
后端處理回調(diào)請求：后端接收到微信的回調(diào)請求，通過授權(quán)碼 code 獲取訪問令牌 access_token 和用戶的 openid。
獲取用戶信息：使用 access_token 和 openid 調(diào)用微信API獲取用戶詳細(xì)信息。
展示用戶信息：將獲取到的用戶信息展示在頁面上。