Node.js游戏服务器项目移植 6-轻量化Token登录概述

之前的项目是Express考虑再三还是决定继续沿用之前的技术栈。首先处理的是登录系统需要实现邮箱登录手机登录微信登录这篇文章只写了邮箱登录。老项目没有使用redis需要实现这一部分。一、简介服务框架Express轻量高效的Node.js Web框架专注接口开发数据库MongoDB非关系型数据库适配游戏用户、普通用户数据存储数据解析body-parser解析前端JSON、表单请求参数唯一ID生成uuid生成Token、用户唯一玩家ID数据加密自定义工具类MD5加密密码脱敏存储身份认证内存缓存Token轻量化无状态登录二、设计思路不适用传统SessionCookie的登录模式采用Token无状态认证方案用户登录/注册成功后服务端生成唯一UUID Token作为身份凭证服务端通过内存缓存维护Token与用户信息的映射关系快速校验身份前端持有Token后续所有接口请求携带Token完成身份鉴权支持邮箱一键自动注册登录、独立注册、测试快捷登录三种场景统一接口返回格式全局跨域配置适配前后端分离开发。三、功能拆解1. 基础服务与全局中间件配置项目初始化后首先配置全局通用中间件解决前后端开发核心问题参数解析与跨域报错。通过body-parser实现对前端POST请求的JSON、表单数据解析保证后端可正常获取req.body参数自定义CORS跨域中间件放行所有域名、请求头和请求方法同时处理浏览器OPTIONS预检请求彻底解决本地调试跨域问题。2. 数据库连接封装系统封装了全局数据库实例与懒连接函数ensureDb核心优势为按需连接、避免资源浪费。服务启动后不会立即连接数据库仅在执行登录、注册等数据库操作时先判断连接状态未连接则自动完成连接有效避免服务启动耗时过长、数据库无效占用等问题适配轻量化服务部署。3. 工具能力封装核心基础为保证系统统一性封装了三类核心工具方法Token生成基于uuid.v4生成随机唯一令牌作为用户登录凭证玩家ID生成基于uuid.v1去除横杠生成无重复用户唯一标识用于业务关联Token内存缓存以键值对形式存储Token、用户信息、创建时间实现高效身份查询无需每次查询数据库。4. 接口实现4.1 邮箱自动注册登录接口接口地址POST /api/login/email核心的业务接口区别于传统登录系统可以进行无账号自动注册登录极大优化用户体验参数校验校验邮箱、密码非空正则验证邮箱格式限制密码最低6位密码脱敏将前端传入的明文密码通过MD5加密后再校验/存储杜绝明文存储风险智能分支逻辑邮箱未注册则自动创建账号、生成昵称并登录邮箱已注册则校验密码密码正确更新最后登录时间生成Token并缓存用户信息统一返回登录结果区分新用户和老用户登录场景。4.2 测试快捷登录接口接口地址POST /api/login/test为测试场景设计输入固定密钥即可快速生成临时测试账号无需手动注册大幅提升调试效率。自动创建唯一测试用户复用登录逻辑生成Token不影响正式用户数据。4.3 独立邮箱注册接口接口地址POST /api/register前端暂时留空提供纯注册能力校验邮箱唯一性避免重复注册支持自定义昵称注册成功后返回用户基础信息适配需要先注册、后登录的业务场景与自动登录接口形成互补。4.4 Token鉴权查询用户接口接口地址GET /api/user/me前端通过携带Token查询当前登录用户信息校验Token有效性实现页面登录态校验、用户信息回显功能是前端全局身份校验的核心接口。四、现有方案缺陷与生产级优化方案4.1 现有短板内存缓存局限性Token存储在服务器内存服务重启后登录态全部失效多实例部署无法共享登录态Token无过期机制当前Token永久有效存在账号被盗用、长期占用缓存的风险安全策略薄弱仅MD5加密密码无加盐、跨域全开、无接口限流、无防刷机制异常处理简单统一返回通用错误信息不利于线上问题排查。4.2 生产级优化建议缓存升级将内存缓存替换为Redis实现Token分布式存储、自动过期、多服务共享登录态增加Token过期机制配置2小时/24小时过期时间新增刷新Token接口保障账号安全密码加密升级MD5加盐加密或替换为bcrypt加密避免彩虹表破解安全加固限制指定域名跨域、添加接口限流、请求参数脱敏、恶意请求拦截日志优化细分错误日志、操作日志记录用户登录IP、时间、设备信息便于问题追溯。笔者注因为需求如此不需要继续深入优化这套基础方案可以应付当前项目后继使用redis其他无必要花费精力。