- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权; 已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF), 开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。 单测 91 个通过(不需要本机数据库)。 - frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 / 首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。 - extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。 - 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、 .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
170 lines
6.1 KiB
JavaScript
170 lines
6.1 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
|
||
/**
|
||
* 扫码登录的**公开**接口(发码 / 查码)—— 谁来调都行,不需要令牌
|
||
*
|
||
* 面向:登录页(浏览器内联脚本)、Win 客户端、任何想自己画二维码显示的前端。
|
||
* 确认环节在 `app/controller/client/wechat.js`(需要 user JWT);设备端扫码登录在 `app/controller/device/auth.js`。
|
||
*/
|
||
class WechatAuthController extends Controller {
|
||
/**
|
||
* GET /api/wechat/qrcode.svg?code=xxxxxx —— 登录码的二维码(SVG,**本地生成**,零外链)
|
||
* 内容就是本站地址 `/wechat?spm=1.0.<码>.1`(手机扫到后打开前端路由)
|
||
*/
|
||
async qrcode() {
|
||
const { ctx } = this;
|
||
const code = String(ctx.query.code || '');
|
||
const content = ctx.service.wechatLogin.qrContent({ code, origin: ctx.app.config.email.siteUrl || ctx.origin });
|
||
|
||
ctx.set('Cache-Control', 'no-store');
|
||
ctx.type = 'image/svg+xml; charset=utf-8';
|
||
ctx.body = ctx.service.wechatLogin.qrSvg(content);
|
||
}
|
||
|
||
/**
|
||
* GET /api/wechat/login —— 扫码登录接口(前端 JS/SPA 用,不依赖页面渲染)
|
||
* - **不带参数**:生成一个 6 位串码(数字+字母,存 Redis)并返回二维码地址,前端拿去画二维码;
|
||
* - **带 `?code=`**:轮询状态;手机确认后:**写入登录会话 + 返回用户 JWT**,前端存下 JWT 即完成登录。
|
||
*/
|
||
async login() {
|
||
const { ctx } = this;
|
||
const svc = ctx.service.wechatLogin;
|
||
const raw = String(ctx.query.code || '').trim();
|
||
|
||
if (!raw) {
|
||
const code = await svc.newCode();
|
||
ctx.body = {
|
||
ok: true,
|
||
data: {
|
||
code,
|
||
spm: svc.spm(code),
|
||
qrUrl: `/api/wechat/qrcode.svg?code=${encodeURIComponent(code)}`,
|
||
expiresIn: svc.stateTtl,
|
||
},
|
||
};
|
||
return;
|
||
}
|
||
|
||
const code = raw.toUpperCase();
|
||
const expect = Number(ctx.app.config.wechat.codeLength || 6);
|
||
if (!new RegExp(`^[0-9A-Z]{${expect}}$`).test(code)) {
|
||
ctx.status = 422;
|
||
ctx.body = { ok: false, message: `code 格式不对(${expect} 位数字 + 字母)` };
|
||
return;
|
||
}
|
||
|
||
// ?wait=25 走长轮询(最多挂起到 config.wechat.pollWait):有人登录立即返回,
|
||
// 到时间还没动静就直接给一张新码(status=refreshed),前端换二维码后继续请求
|
||
const result = await svc.awaitLogin(code, { wait: ctx.query.wait });
|
||
|
||
if (result.status === 'aborted') {
|
||
// 客户端已经断开(切回账号密码登录 / 关页签 / 前端 abort):没什么可回的,也不用写响应
|
||
ctx.respond = false;
|
||
return;
|
||
}
|
||
|
||
if (result.status === 'refreshed') {
|
||
ctx.body = {
|
||
ok: true,
|
||
data: {
|
||
status: 'refreshed',
|
||
code: result.code,
|
||
spm: svc.spm(result.code),
|
||
qrUrl: `/api/wechat/qrcode.svg?code=${encodeURIComponent(result.code)}`,
|
||
expiresIn: svc.stateTtl,
|
||
waited: result.waited || 0,
|
||
},
|
||
};
|
||
return;
|
||
}
|
||
if (result.status !== 'confirmed') {
|
||
ctx.body = { ok: true, data: { status: result.status } };
|
||
return;
|
||
}
|
||
|
||
// 手机已确认:后端只下发 JWT(前端存本地),**不写 cookie/session**
|
||
const user = result.user;
|
||
ctx.logger.info('[wechat] %s 扫码登录成功(API)', user.username);
|
||
|
||
ctx.body = {
|
||
ok: true,
|
||
data: {
|
||
status: 'confirmed',
|
||
token: result.token,
|
||
tokenType: result.tokenType,
|
||
expiresIn: result.expiresIn,
|
||
user: {
|
||
id: user.id,
|
||
username: user.username,
|
||
nickname: user.nickname || null,
|
||
email: user.email || null,
|
||
phone: user.phone || null,
|
||
avatar: user.avatar || null,
|
||
},
|
||
},
|
||
};
|
||
}
|
||
|
||
/**
|
||
* GET /api/wechat/callback?code=&state= —— 微信公众号网页授权回调
|
||
*
|
||
* 微信把**手机浏览器**重定向到这里(回调地址可在微信平台配 `WECHAT_REDIRECT_URI`,
|
||
* 不配就用 `<origin>/api/wechat/callback`)。这里不登录扫码设备,只把「已确认的用户 id」
|
||
* 写进 Redis,等电脑上的登录页长轮询取走;处理完把浏览器转回**前端**的 `/wechat` 路由,
|
||
* 由前端给出“已确认/失败”的文案。
|
||
*/
|
||
async callback() {
|
||
const { ctx } = this;
|
||
const state = String(ctx.query.state || '');
|
||
const result = await ctx.service.wechatLogin.login(String(ctx.query.code || ''), state);
|
||
|
||
if (!result.ok) ctx.logger.warn('[wechat] 扫码失败: %s', result.message);
|
||
|
||
const spm = ctx.service.wechatLogin.parseSpm(state) ? ctx.service.wechatLogin.spm(state) : '';
|
||
const base = String(ctx.app.config.email.siteUrl || ctx.origin || '').replace(/\/+$/, '');
|
||
const query = new URLSearchParams({ ok: result.ok ? '1' : '0' });
|
||
if (spm) query.set('spm', spm);
|
||
if (!result.ok) query.set('message', result.message || '扫码失败,请重新扫码');
|
||
|
||
ctx.redirect(`${base}/wechat?${query.toString()}`);
|
||
}
|
||
|
||
/**
|
||
* GET /api/wechat/status —— 查串码状态(**无需登录**,小程序/网页先问一下再决定怎么提示)
|
||
*
|
||
* query: `?code=` 或 `?spm=`(也可以直接把二维码里扫到的整条地址丢进来)
|
||
* 返回 `data.status`:pending(待扫码)/ confirmed(已被确认)/ expired(不存在或已过期,即“没这个码”)
|
||
*/
|
||
async status() {
|
||
const { ctx } = this;
|
||
const svc = ctx.service.wechatLogin;
|
||
const code = svc.parseSpm(ctx.query.code || ctx.query.spm);
|
||
|
||
if (!code) {
|
||
ctx.status = 422;
|
||
ctx.body = {
|
||
ok: false,
|
||
status: 'bad_format',
|
||
message: `登录码格式不对(${Number(ctx.app.config.wechat.codeLength || 6)} 位数字 + 字母)`,
|
||
};
|
||
return;
|
||
}
|
||
|
||
const state = await svc.statusOf(code);
|
||
ctx.body = {
|
||
ok: true,
|
||
data: {
|
||
status: state.status,
|
||
code,
|
||
spm: svc.spm(code),
|
||
qrUrl: `/api/wechat/qrcode.svg?code=${encodeURIComponent(code)}`,
|
||
expiresIn: state.expiresIn,
|
||
},
|
||
};
|
||
}
|
||
}
|
||
|
||
module.exports = WechatAuthController;
|