packServer/backend/app/service/wechat_mp.js
liufumingren 4f637f1307 feat(web): 微信小程序 code2Session 登录与账号绑定
- POST /api/web/auth/wechat/login:code 换 openid,已绑定直接签发令牌,
  未绑定自动建平台账号(首登标记 firstTime)
- bind / bindings / unbind:登录态下绑定、查询、解绑小程序账号
- wechat_mp_accounts 表 + 迁移;未配置 WX_MP_APPID/SECRET 时本地与单测走 mock
- 新增 cors 中间件(小程序 H5 预览直连后端;鉴权只靠 header 令牌,不依赖 cookie)
- 补充 wechat-mp 接口单测

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:11 +08:00

273 lines
9.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { Service } = require('egg');
const crypto = require('crypto');
const { Op } = require('sequelize');
/** 小程序登录的 mock 前缀:`mock:<openid>` 直接指定 openid,方便本地联调固定账号 */
const MOCK_PREFIX = 'mock:';
/**
* 微信小程序登录 / 绑定
*
* 链路:`uni.login()` 拿 code → `jscode2session` 换 openid →
* 按 (appid, openid) 找 `wechat_mp_accounts`:
* - 已绑定平台账号 → 签发该账号的 user JWT(`firstTime: false`);
* - 未绑定 → 自动建平台账号(`wx_<openid 尾部>`,随机密码)并绑定(`firstTime: true`)。
*
* 未配置 `WX_MP_APPID / WX_MP_SECRET` 时(本地 / 单测),走 mock:
* 传 `mock:<openid>` 固定账号,或任意 code 按 sha1 推导 openid。生产必须显式 `WX_MP_MOCK=true` 才允许 mock。
*/
class WechatMpService extends Service {
get cfg() {
return this.app.config.wechat.mp || {};
}
get Account() {
return this.app.model.WechatMpAccount;
}
/** 配置齐全(有 appid + secret)才算真机模式 */
get enabled() {
return Boolean(this.cfg.appid && this.cfg.secret);
}
/** mock 是否可用 */
get mockEnabled() {
if (this.cfg.mock) return true;
return !this.enabled && this.app.config.env !== 'prod';
}
get appid() {
return this.cfg.appid || 'mock-appid';
}
get apiBase() {
return this.cfg.apiBase || 'https://api.weixin.qq.com';
}
/**
* code → openid
* @param {string} code `uni.login()` 返回的 code(本地可用 `mock:<openid>`)
*/
async code2Session(code) {
const jsCode = String(code || '').trim();
if (!jsCode) this.ctx.throw(422, '缺少微信登录 code');
if (jsCode.startsWith(MOCK_PREFIX)) {
if (!this.mockEnabled) this.ctx.throw(400, 'mock 微信登录未开启');
const openid = this.normalizeOpenid(jsCode.slice(MOCK_PREFIX.length));
return { openid, unionid: null, sessionKey: null, devMode: true };
}
if (!this.enabled) {
if (!this.mockEnabled) {
this.ctx.throw(503, '微信小程序登录未配置(WX_MP_APPID / WX_MP_SECRET)');
}
const digest = crypto.createHash('sha1').update(jsCode).digest('hex').slice(0, 24);
this.ctx.logger.warn('[wechat-mp] 未配置 appid/secret,使用 mock openid=%s', digest);
return { openid: `mock_${digest}`, unionid: null, sessionKey: null, devMode: true };
}
const res = await this.ctx.curl(`${this.apiBase}/sns/jscode2session`, {
data: {
appid: this.cfg.appid,
secret: this.cfg.secret,
js_code: jsCode,
grant_type: 'authorization_code',
},
dataType: 'json',
timeout: 8000,
});
const data = res.data || {};
if (data.errcode) {
this.ctx.logger.warn('[wechat-mp] jscode2session 失败: %s %s', data.errcode, data.errmsg);
this.ctx.throw(401, `微信登录失败:${data.errmsg || data.errcode}(code 可能已过期,请重试)`);
}
if (!data.openid) {
this.ctx.logger.error('[wechat-mp] jscode2session 未返回 openid: %s', JSON.stringify(data));
this.ctx.throw(502, '微信登录失败:未获取到 openid');
}
return {
openid: String(data.openid),
unionid: data.unionid || null,
sessionKey: data.session_key || null,
devMode: false,
};
}
/** 只保留 openid 允许的字符,并限制长度(DB 是 varchar(64)) */
normalizeOpenid(value) {
const openid = String(value || '').replace(/[^A-Za-z0-9_\-@.]/g, '').slice(0, 64);
return openid || 'mock_default';
}
/**
* 小程序登录
* @param {object} params code / userInfo(可选微信昵称头像)/ client
* @return {Promise<{user:object, binding:object, firstTime:boolean}>}
*/
async login({ code, userInfo }) {
const session = await this.code2Session(code);
const appid = this.appid;
let account = await this.Account.findOne({ where: { appid, openid: session.openid } });
let firstTime = false;
if (!account) {
account = await this.Account.create({
appid,
openid: session.openid,
unionid: session.unionid,
nickname: this.pickNickname(userInfo),
avatar: this.pickAvatar(userInfo),
sessionKey: session.sessionKey,
lastLoginAt: new Date(),
loginCount: 0,
});
firstTime = true;
}
if (account.status === 0) {
this.ctx.throw(403, '该微信已被停用,请联系管理员');
}
let user = account.userId ? await this.ctx.service.user.findById(account.userId) : null;
if (!user) {
user = await this.createUserFor(account, userInfo);
firstTime = true;
}
await account.update({
userId: user.id,
unionid: session.unionid || account.unionid,
sessionKey: session.sessionKey,
nickname: this.pickNickname(userInfo) || account.nickname,
avatar: this.pickAvatar(userInfo) || account.avatar,
lastLoginAt: new Date(),
loginCount: Number(account.loginCount || 0) + 1,
});
if (Number(user.status) !== 1) {
this.ctx.throw(403, '账号已被禁用,请联系管理员');
}
await this.ctx.service.user.touchLogin(user.id);
this.ctx.logger.info('[wechat-mp] 登录成功 userId=%s openid=%s firstTime=%s', user.id, session.openid, firstTime);
return { user, binding: this.toPublic(account.toJSON()), firstTime };
}
/**
* 把微信绑定到已有账号(需 user 令牌)
* 该 openid 已绑定别的账号 → 409(先解绑)
*/
async bind(userId, { code, userInfo }) {
const session = await this.code2Session(code);
const appid = this.appid;
const exists = await this.Account.findOne({ where: { appid, openid: session.openid } });
if (exists && exists.userId && Number(exists.userId) !== Number(userId)) {
this.ctx.throw(409, '该微信已绑定其他账号,请先在对应账号里解绑');
}
if (exists && exists.status === 0) this.ctx.throw(403, '该微信已被停用');
const payload = {
userId,
unionid: session.unionid || (exists && exists.unionid) || null,
sessionKey: session.sessionKey,
nickname: this.pickNickname(userInfo) || (exists && exists.nickname) || '',
avatar: this.pickAvatar(userInfo) || (exists && exists.avatar) || '',
lastLoginAt: new Date(),
};
const account = exists
? await exists.update(payload)
: await this.Account.create(Object.assign({ appid, openid: session.openid, loginCount: 0 }, payload));
this.ctx.logger.info('[wechat-mp] 用户 %s 绑定微信 openid=%s', userId, session.openid);
return this.toPublic((account.toJSON ? account.toJSON() : account));
}
/** 当前账号的微信绑定列表 */
async listByUser(userId) {
const rows = await this.Account.findAll({ where: { userId }, order: [[ 'id', 'DESC' ]] });
return rows.map(row => this.toPublic(row.toJSON()));
}
/** 解绑:解绑后该 openid 不能再登录;至少要保留一种登录方式 */
async unbind(userId, id) {
const account = await this.Account.findByPk(id);
if (!account || Number(account.userId) !== Number(userId)) this.ctx.throw(404, '绑定不存在');
const user = await this.ctx.service.user.findByIdWithPassword(userId);
const others = await this.Account.count({ where: { userId, id: { [Op.ne]: account.id } } });
if (!(user && user.passwordHash) && others === 0) {
this.ctx.throw(422, '这是唯一的登录方式,请先设置密码再解绑');
}
await account.update({ userId: null });
this.ctx.logger.info('[wechat-mp] 用户 %s 解绑微信 id=%s', userId, id);
return { id: Number(account.id) };
}
/** 给新 openid 建一个平台账号(用户名 wx_xxx,随机密码,用户可用「找回密码」设置) */
async createUserFor(account, userInfo) {
const nickname = this.pickNickname(userInfo) || '微信用户';
const password = crypto.randomBytes(24).toString('hex');
let lastError = null;
for (let i = 0; i < 5; i++) {
const username = this.candidateUsername(account.openid, i);
try {
const user = await this.ctx.service.auth.register({
username,
password,
nickname,
email: null,
phone: null,
});
const avatar = this.pickAvatar(userInfo);
if (avatar) await this.ctx.service.user.update(user.id, { avatar });
this.ctx.logger.info('[wechat-mp] 新用户注册: %s (id=%s, openid=%s)', username, user.id, account.openid);
return this.ctx.service.user.findById(user.id) || user;
} catch (err) {
if (err.status !== 409) throw err;
lastError = err;
}
}
throw lastError || new Error('创建微信账号失败');
}
/** `wx_` + openid 末尾 12 位;重名时加随机后缀 */
candidateUsername(openid, attempt) {
const tail = String(openid).replace(/[^A-Za-z0-9_]/g, '').slice(-12) || 'user';
if (attempt === 0) return `wx_${tail}`;
return `wx_${tail}_${crypto.randomBytes(3).toString('hex')}`;
}
pickNickname(userInfo) {
const nickname = String((userInfo && userInfo.nickname) || '').trim().slice(0, 64);
return nickname || '';
}
pickAvatar(userInfo) {
const avatar = String((userInfo && userInfo.avatar) || '').trim().slice(0, 255);
return avatar || '';
}
/** 对外结构(不吐 session_key / appid 内部细节) */
toPublic(row) {
return {
id: Number(row.id),
userId: row.userId ? Number(row.userId) : null,
nickname: row.nickname || '',
avatar: row.avatar || '',
unionid: row.unionid || null,
lastLoginAt: row.lastLoginAt || null,
loginCount: Number(row.loginCount || 0),
};
}
}
module.exports = WechatMpService;