微信公众号扫码登录功能实现:Java后端集成指南

2024-11-29 11:36 更新

大家好,我是 V哥。扫码登录是个很普遍的功能,通过与公众号联动实现扫码登录功能,要怎么做呢,V 哥整理了以下步骤和代码,供你参考。这里假设你已经有一个Java后端应用,并且微信开发者平台的配置也已经完成。(相信你可以根据微信开放平台的操作进行)整个流程包括二维码生成、扫码后获取微信用户信息、并将用户登录状态返回到你的应用中。

1. 微信公众号扫码登录流程

  1. 申请扫码登录权限:在微信开放平台申请扫码登录权限。
  2. 生成二维码:使用微信提供的接口生成一个包含应用授权信息的二维码。
  3. 用户扫码授权:用户扫描二维码,授权登录。
  4. 获取授权码:用户授权后,微信会回调给开发者一个授权码。
  5. 获取用户信息:使用授权码获取用户的基本信息(如昵称、头像等)。
  6. 建立会话:将用户信息与系统的会话绑定,完成登录流程。

2. 前置准备

确保你在微信开放平台上配置了以下信息:

  • AppID 和 AppSecret:在“公众号设置”页面可以找到。
  • 授权回调域名:在开放平台进行授权配置。

3. Java 实现扫码登录

使用Spring Boot实现一个简单的微信扫码登录后端接口:

导入依赖

pom.xml 中添加必要的依赖项:

<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>

代码实现

  1. 配置微信相关信息

   @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. 生成二维码

创建一个控制器来生成微信扫码二维码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. 回调接口

微信扫码后会将用户重定向到配置的回调URL,在回调中处理授权码并获取用户信息。

   @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. 会话管理与重定向

在获取到用户信息后,可以将用户数据存入Redis(或数据库),并生成一个登录态。

   @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. 前端处理

在前端页面中调用 /api/wechat/login/qrcode 接口,将二维码显示给用户。当用户扫码并完成授权后,前端可以获取后端传回的Session ID,表示登录成功。

完整流程小结

  1. 访问后端接口生成二维码链接。
  2. 前端显示二维码,用户扫码后进入微信授权页面。
  3. 授权成功后,微信重定向至后端的 /callback
  4. 后端使用 code 获取用户信息,并保存会话信息(如Redis)。
  5. 返回前端Session ID作为登录凭证。

使用以上代码和步骤可以实现完整的微信公众号扫码登录流程,前端就可以使用得到的Session ID来维护用户登录状态啦。

由于演示案例涉及自己的账号信息和微信开放平台的私密信息,请根据自己的情况使用代码案例,下课。微信扫码登录, Java后端实现, Spring Boot, 微信公众号, 微信开放平台, 二维码生成, 用户授权, 会话管理

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号