'use strict'; const { Controller } = require('egg'); /** 路径参数转正整数,非法返回 null */ function toId(value) { const id = Number(value); return Number.isInteger(id) && id > 0 ? id : null; } /** * web 用户端:微信登录网关(扫码登录 / 绑定微信) * * 取代了旧的「自建 6 位登录码」:二维码内容由网关下发(`pageUrl`), * 用户扫码确认后网关回调本服务,本服务把结果放回会话,浏览器长轮询取走。 * * - `POST /api/web/auth/wechat-gateway/qrcode`(公开)申请登录二维码 → `{ state, qrUrl, pageUrl, expiresIn }` * - `GET /api/web/auth/wechat-gateway/login`(公开)长轮询:`?state=&wait=` → `{ status, token?, user? }` * - `GET /api/wechat-gateway/qrcode.svg|gif`(公开)把会话里的网关地址画成二维码(本地生成,零外链) * - `POST /api/web/me/wechat/qrcode`(需令牌)申请「绑定微信」二维码 * - `GET /api/web/me/wechat/status`(需令牌)长轮询绑定结果 * - `GET /api/web/me/wechat/bindings`(需令牌)当前账号已绑定的微信 * - `DELETE /api/web/me/wechat/bindings/:id`(需令牌)解绑 */ class WebWxGatewayController extends Controller { /** * 没配网关时返回 503 + 明确提示 * * ⚠️ 5xx 的 `ctx.throw` 会被统一错误处理遮成「服务器内部错误」,前端就拿不到原因了, * 所以这里直接写 body。 */ ensureEnabled() { if (this.ctx.service.wxGateway.enabled) return true; this.ctx.status = 503; this.ctx.body = { ok: false, message: '未开通微信扫码登录(服务端未配置微信登录网关)' }; return false; } /** * POST /api/web/auth/wechat-gateway/qrcode —— 申请登录二维码 * * 没配网关时返回 503(前端据此提示「未开通微信扫码登录」)。 */ async createLoginQr() { const { ctx } = this; if (!this.ensureEnabled()) return; const session = await ctx.service.wxGateway.openSession({ purpose: 'login', scene: 'login', }); ctx.body = { ok: true, data: { state: session.state, pageUrl: session.pageUrl, qrUrl: `/api/wechat-gateway/qrcode.svg?state=${encodeURIComponent(session.state)}`, expiresIn: session.expiresIn, }, }; } /** * GET /api/web/auth/wechat-gateway/login?state=&wait= —— 长轮询登录结果 * * 确认后当场签发用户 JWT(令牌不落 Redis,只经过这一次响应): * `{ status:'confirmed', token, tokenType, expiresIn, user }` */ async loginStatus() { const { ctx } = this; const result = await ctx.service.wxGateway.awaitSession(String(ctx.query.state || ''), { wait: ctx.query.wait, }); if (result.status === 'aborted') { // 客户端已经断开(切回账号密码登录 / 关页签):不用写响应 ctx.respond = false; return; } if (result.status !== 'confirmed') { ctx.body = { ok: true, data: result }; return; } const user = await ctx.service.user.findById(Number(result.userId)); if (!user) { ctx.body = { ok: true, data: { status: 'failed', message: '绑定的平台账号不存在,请联系管理员' } }; return; } ctx.logger.info('[wx-gateway] %s 扫码登录成功(API)', user.username); ctx.body = { ok: true, data: { status: 'confirmed', token: ctx.service.jwt.signUser(user), tokenType: 'Bearer', expiresIn: ctx.app.config.jwt.userExpiresIn, 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-gateway/qrcode.svg?state= —— 二维码 SVG(本地画,不引用任何外链) */ async qrSvg() { const { ctx } = this; const content = await this.contentOfState(String(ctx.query.state || '')); if (!content) ctx.throw(404, '二维码已失效,请刷新'); ctx.set('Cache-Control', 'no-store'); ctx.type = 'image/svg+xml; charset=utf-8'; ctx.body = ctx.service.wechatLogin.qrSvg(content); } /** GET /api/wechat-gateway/qrcode.gif?state= —— 同一张二维码的 GIF(桌面端 WPF 不能渲染 SVG) */ async qrGif() { const { ctx } = this; const content = await this.contentOfState(String(ctx.query.state || '')); if (!content) ctx.throw(404, '二维码已失效,请刷新'); ctx.set('Cache-Control', 'no-store'); ctx.type = 'image/gif'; ctx.body = ctx.service.wechatLogin.qrGif(content); } /** POST /api/web/me/wechat/qrcode —— 申请「绑定微信」二维码(绑定到当前账号) */ async createBindQr() { const { ctx } = this; if (!this.ensureEnabled()) return; const session = await ctx.service.wxGateway.openSession({ purpose: 'bind', scene: 'bind', payload: { userId: Number(ctx.state.user.id) }, }); ctx.body = { ok: true, data: { state: session.state, pageUrl: session.pageUrl, qrUrl: `/api/wechat-gateway/qrcode.svg?state=${encodeURIComponent(session.state)}`, expiresIn: session.expiresIn, }, }; } /** GET /api/web/me/wechat/status?state=&wait= —— 长轮询绑定结果 */ async bindStatus() { const { ctx } = this; const result = await ctx.service.wxGateway.awaitSession(String(ctx.query.state || ''), { wait: ctx.query.wait, }); if (result.status === 'aborted') { ctx.respond = false; return; } ctx.body = { ok: true, data: result }; } /** GET /api/web/me/wechat/bindings —— 当前账号已绑定的微信 */ async bindings() { const { ctx } = this; const list = await ctx.service.wxGateway.listBindings(ctx.state.user.id); ctx.body = { ok: true, data: { list, // 没配网关时前端把「绑定微信」整块灰掉(而不是点了才报错) enabled: ctx.service.wxGateway.enabled, }, }; } /** DELETE /api/web/me/wechat/bindings/:id —— 解绑 */ async unbind() { const { ctx } = this; const id = toId(ctx.params.id); if (!id) ctx.throw(400, 'id 必须是正整数'); const data = await ctx.service.wxGateway.unbind(ctx.state.user.id, id); ctx.body = { ok: true, data }; } /** 会话里的二维码内容(网关授权页地址);会话没了返回空串 */ async contentOfState(state) { if (!state) return ''; return this.ctx.service.wxGateway.pageUrlOf(state); } } module.exports = WebWxGatewayController;