微信登录

Feature: wx-login-mini / wx-login-app / wx-login-web

统一的微信登录模块，支持小程序、APP、网页扫码三种登录方式，共享 [wxlogin] 配置段。

公众号网页授权登录已合并到 wx-official 模块，详见 wx-official.md。

配置

[wxlogin]
# 小程序登录
mini_id = "wx1234567890"
mini_secret = ""

# APP 登录
app_id = "wx1234567890"
app_secret = ""

# 网页扫码登录
web_id = ""
web_secret = ""
redirect_base = "https://example.com"
# callback_path = "auth/wechat/callback"  # 默认值，框架自动注册回调路由

各登录方式只需配置对应的字段即可，未启用的 feature 对应的字段可省略。

小程序登录

Feature: wx-login-mini

📖 官方文档：https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html

小程序前端通过 wx.login() 获取 code，后端调用 mini_login 换取 openid 和 session_key。

使用示例

#![allow(unused)]
fn main() {
let result = state.wxlogin.mini_login(&code).await?;
let openid = result.openid;
let session_key = result.session_key;
}

API

MiniLoginResponse

APP 登录

Feature: wx-login-app

📖 官方文档：https://developers.weixin.qq.com/doc/oplatform/Mobile_App/operation.html

APP 端通过微信 SDK 获取 code，后端调用 app_login 换取 access_token 和 openid。

使用示例

#![allow(unused)]
fn main() {
let result = state.wxlogin.app_login(&code).await?;
let access_token = result.access_token;
let openid = result.openid;
}

API

AppLoginResponse

网页扫码登录

Feature: wx-login-web

📖 官方文档：https://developers.weixin.qq.com/doc/oplatform/Website_App/WeChat_Login/Wechat_Login.html

基于 OAuth2.0 协议，网站应用通过微信扫码完成登录。支持自动回调和手动调用两种方式。

授权流程

┌──────────┐     1. 跳转授权页         ┌──────────┐
│  前端页面 │ ──────────────────────▶ │  微信扫码 │
└──────────┘                          └──────────┘
     ▲                                    │
     │         2. 扫码授权, 回调 code       │
     │ ◀──────────────────────────────────┘
     │
     │  3. 后端通过 code 换取 access_token
     │  4. 获取用户信息
     │  5. 返回登录结果
     ▼
┌──────────┐
│  业务逻辑  │
└──────────┘

方式一：自动回调（推荐）

框架自动注册回调路由，用户扫码授权后微信重定向到回调地址，自动完成登录流程。

#![allow(unused)]
fn main() {
AFaster::new("config.toml".into())
    .await?
    .with_wxlogin(|w| {
        w.with_web_callback(|(state, result, oauth_state)| async move {
            println!("openid: {}", result.openid);
            Ok(result)
        })
    })
    .service(your_services)
    .run()
    .await;
}

前端跳转：

#![allow(unused)]
fn main() {
let url = state.wxlogin.get_authorize_url(Some("random_state"));
// => https://open.weixin.qq.com/connect/qrconnect?appid=...&redirect_uri=...&scope=snsapi_login&state=random_state#wechat_redirect
}

方式二：手动调用

#![allow(unused)]
fn main() {
// 1. 生成授权 URL
let authorize_url = state.wxlogin.get_authorize_url(Some("my_state"));

// 2. 用户扫码后，微信回调 redirect_uri?code=CODE&state=my_state

// 3. 通过 code 换取 access_token
let token = state.wxlogin.web_login("CODE").await?;

// 4. 获取用户信息
let userinfo = state.wxlogin.web_get_userinfo(&token.access_token, &token.openid, None).await?;

// 5. 刷新 access_token（有效期 2 小时，refresh_token 有效期 30 天）
let refreshed = state.wxlogin.web_refresh_token(&token.refresh_token).await?;

// 6. 检验 access_token 是否有效
let is_valid = state.wxlogin.web_check_token(&token.access_token, &token.openid).await?;

// 7. 完整登录流程（自动获取 userinfo）
let result = state.wxlogin.web_login_full("CODE").await?;
}

内嵌二维码

前端可使用微信 JS SDK 将二维码内嵌到页面中，用户扫码后通过 JS 获取 code 再调用后端接口：

<script src="http://res.wx.qq.com/connect/zh_CN/htmledition/js/wxLogin.js"></script>
<script>
var obj = new WxLogin({
    self_redirect: true,
    id: "login_container",
    appid: "",
    scope: "snsapi_login",
    redirect_uri: encodeURIComponent("https://example.com/auth/wechat/callback"),
    state: "random_state",
    style: "black"
});
</script>

API

WxWebAccessTokenResponse

WxWebUserInfo

WxWebLoginResult

错误码

小程序（模块 02）

APP（模块 03）

网页扫码（模块 21）

参考文档

• 小程序登录
• APP 登录
• 网站应用微信登录开发指南
• 授权后接口调用（UnionID）