扫码登录是一种便捷的身份认证方式，广泛应用于各种IM和Web应用中。本文详细介绍扫码登录的技术原理、实现方式和主流方案，帮助开发者理解并实现扫码登录功能。
一、引言
下面这张图，不管是IM开发者还是普通用户，应该很熟悉：
于是，搞IM产品的老板和产品经理们，从此又多了一个要抛给程序员们的需求——“为什么微信有一扫登录，而我们的没有？”。
好吧，每次只要是微信有的功能，IM程序员们想甩锅，难度就有点大了，必竟老板们都都会想当然认为，微信有的“我”的IM产品里也得有。
既然无法回避，那就只能老老实实搞懂技术原理，然后自已使劲撸吧。
二、基本技术原理
1）网页端与服务器的配合逻辑
接下来就是对于这个服务的详细实现。
这里确实会有用户的id信息，这个id信息是由手机服务器存入redis中的。具体请继续阅读“手机端与服务器的配合逻辑”。
2）手机端与服务器的配合逻辑
由于手机端已经进行过了登录，在访问手机端的服务器的时候，参数中都回携带一个用户的token，手机端服务器可以从中解析到用户的userId（这里从token中取值而不是手机端直接传userid是为了安全，直接传userid可能会被截获和修改，token是加密的，被修改的风险会小很多）。手机端将解析到的数据和用户token一起作为参数，向服务器发送验证登录请求（这里的服务器是手机服务器，手机端的服务器跟网页端服务器不是同一台服务器）。
服务器收到请求后，首先对比参数中的验证信息，确定是否为用户登录请求接口。如果是，返回一个确认信息给手机端。
手机端收到返回后，将登录确认框显示给用户（防止用户误操作，同时使登录更加人性化）。用户确认是进行的登录操作后，手机再次发送请求。服务器拿到uuId和userId后，将用户的userid作为value值存入redis中以uuid作为key的键值对中。
3）登录成功时的逻辑
然后，浏览器再次发送请求的时候，浏览器端的服务器就可以得到一个用户Id，并调用登录的方法，声成一个浏览器端的token，再浏览器再次发送请求的时候，将用户信息返回给浏览器，登录成功。这里存储用户id而不是直接存储用户信息是因为，手机端的用户信息，不一定是和浏览器端的用户信息完全一致。
4）详细的技术原理总结如下图所示
登录界面 https://login.taobao.com/member/login.jhtml 传回来的参数为：
1 | 然后请求(GET)报文是这样的: |
如果扫了的话则会返回：
当手机端确认登录后，接口返回的是：
表示登录成功，当然手机端与服务端在点击”确认登录”之间的交互可能就是这样：网页端生成的lgToken去请求服务端，服务端记住了这个lgToken并认为登录了，当网页端再次轮询请求接口时，就返回真正的登录态Token，网页端此时就可以凭着这个Token来登录了。
详细的技术逻辑如下图所示：
2.1 技术原理流程图
微信的网页版访问地址是：https://wx.qq.com/，有兴趣也可以自行深入研究
2.2 实际的技术实现逻辑
1 | * 200 已授权：如果手机点击了确认登录，服务器返回200及token -> 前端停止轮询, 获取到token，重定向到目标页 |
具体的代码示例如下：
2.3 小结
三、本文小结
另外，为了方便抓取真实的数据进行分析研究，本文中的PC端案例分析是针对的是网页端，但实际上如果你的PC端是富客户端（也就是。exe、.dmg这样的安装版），原理也是一样的，而且还不需要考虑浏览器里的跨域问题等。
本文标题： 扫码登录功能如何实现一文搞懂主流的扫码登录技术原理
发布时间： 2025年02月15日 00:00
最后更新： 2025年12月30日 08:54
原始链接： https://haoxiang.eu.org/f4273b70/
版权声明： 本文著作权归作者所有，均采用CC BY-NC-SA 4.0许可协议，转载请注明出处！
