'use strict'; const { Controller } = require('egg'); /** * 用户态接口(小程序 / Win 客户端 / SPA 共用) * * 鉴权:`middleware.apiAuth()` —— **只认 header 里的 user JWT**(`Authorization: Bearer `, * 也认 `X-Access-Token`),不看 cookie / session;用户令牌自带 `typ: 'user'`, * 与设备令牌(`typ: 'scanner'`)互不通用。 * * 小程序和 Win 客户端之所以共用一套路径:它们身份相同(都是「某个登录用户」), * 区别只在登录入口;要区分用途请用 header(如 `X-Client: miniapp|win`),不要复制一套路径。 */ class ClientWechatController extends Controller { /** * POST /api/wechat/confirm —— 把登录码断权给当前登录用户(触发电脑端/客户端登录) * * 典型用法(小程序):扫码拿到 `http://<域名>/wechat?spm=1.0.<码>.1`,把扫到的整串、 * `spm` 或 6 位 `code` 丢过来即可(接口自己抽码);后端把码断权给当前登录用户, * 电脑端正在长轮询的请求会**立即**拿到 JWT 完成登录。 * * 需要登录:**只看 header**(`Authorization: Bearer ` 或 `X-Access-Token`),不认 cookie * body: `{ code | spm }`,也支持 `?code=` / `?spm=`(JSON / 表单 / query 都行) * * 返回:成功 `data.status=confirmed`;失败时 body.status = bad_format(422) / expired(410) / * used(410) / unauthorized(401) / forbidden(403) */ async confirm() { const { ctx } = this; const body = ctx.request.body || {}; const raw = body.code || body.spm || ctx.query.code || ctx.query.spm; // 用户只从 header 令牌解析(middleware/api_auth.js 挂的),不从 session 取 const user = (ctx.locals && ctx.locals.user) || (ctx.state && ctx.state.user) || null; const userId = user && user.id; const code = ctx.service.wechatLogin.parseSpm(raw); if (!code) { ctx.status = 422; ctx.body = { ok: false, status: 'bad_format', message: `登录码格式不对(${Number(ctx.app.config.wechat.codeLength || 6)} 位数字 + 字母)`, }; return; } const result = await ctx.service.wechatLogin.confirm(code, userId); if (!result.ok) { // 码不存在/已过期/已被用过 → 410;参数不全 → 422 ctx.status = result.reason === 'bad_param' ? 422 : 410; ctx.body = { ok: false, status: result.reason, message: result.message }; return; } ctx.body = { ok: true, data: { status: 'confirmed', code, spm: ctx.service.wechatLogin.spm(code), user: { id: userId, username: (user && user.username) || null, nickname: (user && user.nickname) || null, }, }, }; } } module.exports = ClientWechatController;