快捷導(dǎo)航

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

更新時(shí)間：2025年10月22日 16:17:18 作者：一個(gè)不懂管理的項(xiàng)目經(jīng)理

本文主要介紹使用SpringBoot框架和微信開放平臺(tái)實(shí)現(xiàn)微信掃碼登錄的功能,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

一、準(zhǔn)備工作

注冊(cè)微信開放平臺(tái)
- 申請(qǐng)網(wǎng)站應(yīng)用，獲取AppID和AppSecret（需 ICP 備案域名）
- 設(shè)置授權(quán)回調(diào)域名（如 www.yourdomain.com）

添加 Maven 依賴

<!-- HTTP請(qǐng)求工具 -->
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.3</version>
</dependency>
<!-- JSON解析 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.3</version>
</dependency>

二、核心代碼實(shí)現(xiàn)

1. 生成微信登錄二維碼（Controller 層）

@RestController
@RequestMapping("/auth/wechat")
public class WechatAuthController {

    // 從配置文件讀?。╝pplication.yml）
    @Value("${wechat.appid}")
    private String appId;

    @Value("${wechat.callback}")
    private String callbackUrl;

    /**
     * 生成微信登錄二維碼的URL
     */
    @GetMapping("/qrcode-url")
    public String getQrCodeUrl() {
        // 微信開放平臺(tái)生成二維碼的固定URL格式
        String url = "https://open.weixin.qq.com/connect/qrconnect" +
                "?appid=%s" +
                "&redirect_uri=%s" +
                "&response_type=code" +
                "&scope=snsapi_login" +  // 固定值
                "&state=YOUR_STATE";     // 防CSRF攻擊隨機(jī)字符串（需存儲(chǔ)校驗(yàn)）

        return String.format(url, appId, URLEncoder.encode(callbackUrl, StandardCharsets.UTF_8));
    }
}

2. 處理微信回調(diào)（獲取用戶信息）

/**
 * 微信回調(diào)接口（需與開放平臺(tái)配置的回調(diào)地址一致）
 */
@GetMapping("/callback")
public ResponseEntity<?> callback(@RequestParam String code, @RequestParam String state) {
    // 1. 校驗(yàn)state參數(shù)（防止CSRF攻擊）
    if (!validateState(state)) {
        return ResponseEntity.badRequest().body("非法請(qǐng)求");
    }

    // 2. 用code換取access_token
    String tokenUrl = "https://api.weixin.qq.com/sns/oauth2/access_token" +
            "?appid=%s" +
            "&secret=%s" +
            "&code=%s" +
            "&grant_type=authorization_code";

    String response = OkHttpUtil.get(String.format(tokenUrl, appId, appSecret, code));
    JsonNode tokenJson = JsonUtil.parse(response);

    // 3. 獲取用戶信息
    String userInfoUrl = "https://api.weixin.qq.com/sns/userinfo" +
            "?access_token=%s" +
            "&openid=%s";

    String userResponse = OkHttpUtil.get(
            String.format(userInfoUrl, tokenJson.get("access_token").asText(),
                                   tokenJson.get("openid").asText()));
    JsonNode userInfo = JsonUtil.parse(userResponse);

    // 4. 處理用戶登錄（示例：創(chuàng)建本地用戶或綁定已有賬號(hào)）
    User user = userService.createOrUpdateWechatUser(userInfo);

    // 5. 生成JWT或Session（此處以JWT為例）
    String jwtToken = JwtUtil.generateToken(user.getId());

    return ResponseEntity.ok().header("Authorization", jwtToken).build();
}

3. 工具類封裝

public class OkHttpUtil {
    /**
     * 發(fā)送GET請(qǐng)求
     */
    public static String get(String url) throws IOException {
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder().url(url).build();
        try (Response response = client.newCall(request).execute()) {
            return response.body().string();
        }
    }
}

public class JsonUtil {
    private static final ObjectMapper mapper = new ObjectMapper();

    /**
     * JSON字符串轉(zhuǎn)對(duì)象
     */
    public static JsonNode parse(String json) throws JsonProcessingException {
        return mapper.readTree(json);
    }
}

三、關(guān)鍵安全措施

State 參數(shù)校驗(yàn)
生成隨機(jī) state 字符串并存儲(chǔ)（如 Redis），回調(diào)時(shí)驗(yàn)證是否匹配。
敏感信息保護(hù)
- AppSecret必須存儲(chǔ)在服務(wù)端，不可暴露給前端
- 用戶 openid 等敏感信息需加密存儲(chǔ)

錯(cuò)誤處理

// 在回調(diào)接口中添加異常處理
try {
    // ... 業(yè)務(wù)邏輯
} catch (WechatApiException e) {
    // 處理微信接口錯(cuò)誤（如code過期）
    return ResponseEntity.status(500).body("微信登錄失?。? + e.getMessage());
}

四、配置示例（application.yml）

wechat:
  appid: wx1234567890abcdef  # 微信應(yīng)用ID
  app-secret: your_app_secret_here  # 微信應(yīng)用密鑰
  callback: https://www.yourdomain.com/auth/wechat/callback  # 授權(quán)回調(diào)地址