【C++ 基于微服务的即时通讯系统】用户服务之Redis数据层落地:会话、登录状态与验证码全封装


🔥草莓熊Lotso: 个人主页
❄️个人专栏: 《C++知识分享》 《Linux 入门到实践:零基础也能懂》
✨生活是默默的坚持,毅力是永久的享受!


🎬 博主简介:


文章目录

  • 前言:
  • 一、Redis数据层整体设计
    • [1.1 会话信息管理](#1.1 会话信息管理)
    • [1.2 登录状态管理](#1.2 登录状态管理)
    • [1.3 验证码信息管理](#1.3 验证码信息管理)
    • [1.4 整体代码结构](#1.4 整体代码结构)
  • 二、Redis数据层代码实现
    • [2.1 Redis客户端工厂类](#2.1 Redis客户端工厂类)
    • [2.2 会话管理类 Session](#2.2 会话管理类 Session)
    • [2.3 登录状态管理类 Status](#2.3 登录状态管理类 Status)
    • [2.4 验证码管理类 Codes](#2.4 验证码管理类 Codes)
  • 三、功能测试与验证
    • [3.1 完整测试代码](#3.1 完整测试代码)
    • [3.2 编译与运行](#3.2 编译与运行)
    • [3.3 常见踩坑](#3.3 常见踩坑)
  • 四、核心要点总结
  • 结尾:

前言:

上一篇我们把用户服务的MySQL持久化数据层完整落地了,解决了用户核心信息的存储问题。但用户服务里还有三类数据,并不适合放MySQL:登录会话、在线状态、短信验证码。它们的共同特点是高频读写、有生命周期、不需要持久化,硬塞给MySQL不仅性能差,还要自己处理过期逻辑,非常麻烦。这类场景天然适合用Redis来做:纯内存操作性能拉满,原生支持TTL自动过期,不用自己写清理逻辑。本篇我们就基于 redis-plus-plus 客户端,把三类Redis数据全部封装成独立的业务管理类,从工厂类、业务接口到完整测试,一步步落地整个Redis数据层。


一、Redis数据层整体设计

用户服务里Redis承担三类临时数据的管理,每一类对应一个独立的业务场景,职责边界非常清晰。

1.1 会话信息管理

存储结构 :key = 会话ID,value = 用户ID的字符串键值对

核心作用 :登录鉴权。用户登录成功后生成一个唯一会话ID,和用户ID绑定存入Redis。后续所有业务请求都携带会话ID,网关或业务服务通过会话ID反查用户ID,完成身份识别。

对应操作:

  • 新增:用户登录成功时创建会话
  • 删除:用户登出或会话过期时删除
  • 获取:每次请求鉴权时查询对应用户ID

1.2 登录状态管理

存储结构 :key = 用户ID,value = 空字符串的键值对

核心作用 :防止用户重复登录。用户登录前先查这个key是否存在,存在说明该账号已经在线,可以选择拒绝登录或者顶掉旧连接。WebSocket长连接断开时,删除对应用户的状态key。

对应操作:

  • 新增:用户建立长连接、登录成功时标记在线
  • 删除:用户断开连接、主动登出时清除标记
  • 判断存在:登录时校验是否重复登录

这里用空值是因为我们只关心「key是否存在」,不需要存具体内容,节省内存。

1.3 验证码信息管理

存储结构 :key = 验证码ID,value = 验证码,附带过期时间

核心作用 :手机号注册、登录、改绑手机号时的校验凭证。用户获取验证码时,生成验证码ID和随机验证码,存入Redis并设置过期时间;用户提交验证时,通过ID取出验证码比对,校验通过后立即删除。

对应操作:

  • 新增:获取验证码时写入,设置有效期(默认60秒)
  • 删除:校验完成后立即删除,防止同一验证码重复使用
  • 获取:提交验证时取出比对

1.4 整体代码结构

我们采用「工厂 + 业务类」的结构:

  • RedisClientFactory:工厂类,统一创建Redis客户端实例,配置连接参数
  • Session:会话管理类,封装会话的增删查
  • Status:登录状态类,封装在线状态的增删判存
  • Codes:验证码管理类,封装验证码的增删查,支持过期时间

三个业务类共用同一个Redis客户端实例,避免重复创建连接,保证连接复用。


二、Redis数据层代码实现

我们选用 redis-plus-plus(简称redis++)作为C++ Redis客户端,它基于hiredis封装,提供了现代化的C++接口,支持智能指针、STL风格调用,比原生hiredis的C接口好用很多。

2.1 Redis客户端工厂类

工厂类负责创建和配置Redis连接,把连接参数封装起来,业务层不用关心底层配置。

复制代码
#pragma once
#include <chrono>
#include <memory>
#include <sw/redis++/redis.h>
#include <sw/redis++/connection.h>

namespace lotso_im {

class RedisClientFactory
{
public:
    static std::shared_ptr<sw::redis::Redis> create(
        const std::string &host,
        int port,
        int db,
        bool keep_alive)
    {
        sw::redis::ConnectionOptions opts;
        opts.host = host;
        opts.port = port;
        opts.db = db;
        opts.keep_alive = keep_alive;

        auto ret = std::make_shared<sw::redis::Redis>(opts);
        return ret;
    }
};

} // namespace lotso_im

代码解读:

  • ConnectionOptions 是redis++的连接配置结构体,核心配置地址、端口、库号、保活开关
  • 返回 shared_ptr 管理的Redis实例,全局共享一个实例即可,不用每次操作新建连接
  • 所有配置参数从外部传入,适配不同环境的Redis部署

2.2 会话管理类 Session

专门管理登录会话,接口非常简洁:新增、删除、查询。

复制代码
class Session
{
public:
    Session(std::shared_ptr<sw::redis::Redis> &redis_client)
        : _redis_client(redis_client) {}

    // 新增会话:会话ID -> 用户ID
    void append(const std::string &ssid, const std::string &uid)
    {
        _redis_client->set(ssid, uid);
    }

    // 删除会话
    void remove(const std::string &ssid)
    {
        _redis_client->del(ssid);
    }

    // 根据会话ID获取用户ID
    sw::redis::OptionalString uid(const std::string &ssid)
    {
        return _redis_client->get(ssid);
    }

private:
    std::shared_ptr<sw::redis::Redis> _redis_client;
};

重点踩坑提醒 :

get 方法的返回值是 sw::redis::OptionalString,绝对不能直接当字符串用 。它类似std::optional,key不存在时是空的,直接解引用会触发崩溃。正确用法是先判断 if (res) 确认有值,再用 *res 取值。这是所有新手用redis++都会踩的第一个坑。

2.3 登录状态管理类 Status

管理用户在线状态,核心是判断key是否存在。

复制代码
class Status
{
public:
    Status(std::shared_ptr<sw::redis::Redis> &redis_client)
        : _redis_client(redis_client) {}

    // 标记用户在线
    void append(const std::string &uid)
    {
        _redis_client->set(uid, "");
    }

    // 清除用户在线状态
    void remove(const std::string &uid)
    {
        _redis_client->del(uid);
    }

    // 判断用户是否在线
    bool exists(const std::string &uid)
    {
        auto ret = _redis_client->get(uid);
        if (ret) return true;
        return false;
    }

private:
    std::shared_ptr<sw::redis::Redis> _redis_client;
};

代码解读:

  • value存空字符串就行,我们只关心key存在与否,不关心内容
  • 这里用 get 判断存在,也可以用 exists 命令,效果是一样的

2.4 验证码管理类 Codes

管理短信验证码,核心是支持设置过期时间,默认有效期60秒。

复制代码
class Codes
{
public:
    Codes(std::shared_ptr<sw::redis::Redis> &redis_client)
        : _redis_client(redis_client) {}

    // 新增验证码,附带过期时间,默认60秒
    void append(const std::string &cid, const std::string &code,
                const std::chrono::milliseconds &t = std::chrono::milliseconds(60000))
    {
        _redis_client->set(cid, code, t);
    }

    // 删除验证码
    void remove(const std::string &cid)
    {
        _redis_client->del(cid);
    }

    // 获取验证码
    sw::redis::OptionalString code(const std::string &cid)
    {
        return _redis_client->get(cid);
    }

private:
    std::shared_ptr<sw::redis::Redis> _redis_client;
};

代码解读:

  • set 方法第三个参数直接传过期时长,redis++ 原生支持 std::chrono 时间类型,不用自己转毫秒数
  • 默认60秒过期,符合短信验证码的常规有效期
  • 业务上校验通过后要手动调用 remove 删除,防止同一个验证码被反复提交使用,安全性更高

三、功能测试与验证

封装完之后必须跑一遍测试,验证增删查和过期机制都符合预期。我们写一个完整的测试程序,分别验证三个模块。

3.1 完整测试代码

复制代码
#include "../../../common/data_redis.hpp"
#include <chrono>
#include <gflags/gflags.h>
#include <memory>
#include <thread>

DEFINE_string(ip, "127.0.0.1", "Redis服务器IP地址");
DEFINE_int32(port, 6379, "Redis服务端口");
DEFINE_int32(db, 0, "Redis库编号,默认0号");
DEFINE_bool(keep_alive, true, "是否开启长连接保活");

// 会话功能测试
void session_test(std::shared_ptr<sw::redis::Redis> &client)
{
    lotso_im::Session ss(client);
    ss.append("会话ID1", "用户ID1");
    ss.append("会话ID2", "用户ID2");
    ss.append("会话ID3", "用户ID3");
    ss.append("会话ID4", "用户ID4");

    ss.remove("会话ID2");
    ss.remove("会话ID3");

    auto res1 = ss.uid("会话ID1");
    if (res1) std::cout << *res1 << std::endl;
    auto res2 = ss.uid("会话ID2");
    if (res2) std::cout << *res2 << std::endl;
    auto res3 = ss.uid("会话ID3");
    if (res3) std::cout << *res3 << std::endl;
    auto res4 = ss.uid("会话ID4");
    if (res4) std::cout << *res4 << std::endl;
}

// 登录状态测试
void status_test(std::shared_ptr<sw::redis::Redis> &client)
{
    lotso_im::Status st(client);
    st.append("用户ID1");
    st.append("用户ID2");
    st.append("用户ID3");

    st.remove("用户ID2");

    if (st.exists("用户ID1")) std::cout << "用户1在线!" << std::endl;
    if (st.exists("用户ID2")) std::cout << "用户2在线!" << std::endl;
    if (st.exists("用户ID3")) std::cout << "用户3在线!" << std::endl;
}

// 验证码功能测试
void code_test(std::shared_ptr<sw::redis::Redis> &client)
{
    lotso_im::Codes cd(client);
    // 测试时缩短过期时间为3秒,方便验证过期效果
    cd.append("验证码ID1", "验证码1", std::chrono::milliseconds(3000));
    cd.append("验证码ID2", "验证码2", std::chrono::milliseconds(3000));
    cd.append("验证码ID3", "验证码3", std::chrono::milliseconds(3000));

    cd.remove("验证码ID2");

    // 立刻查询,应该能查到1和3
    auto y1 = cd.code("验证码ID1");
    auto y2 = cd.code("验证码ID2");
    auto y3 = cd.code("验证码ID3");
    if (y1) std::cout << *y1 << std::endl;
    if (y2) std::cout << *y2 << std::endl;
    if (y3) std::cout << *y3 << std::endl;

    // 等待4秒,超过过期时间
    std::this_thread::sleep_for(std::chrono::seconds(4));

    // 再查询,应该全部不存在
    auto y4 = cd.code("验证码ID1");
    auto y5 = cd.code("验证码ID2");
    auto y6 = cd.code("验证码ID3");
    if (!y4) std::cout << "验证码ID1已过期" << std::endl;
    if (!y5) std::cout << "验证码ID2已过期" << std::endl;
    if (!y6) std::cout << "验证码ID3已过期" << std::endl;
}

int main(int argc, char *argv[])
{
    google::ParseCommandLineFlags(&argc, &argv, true);

    auto client = lotso_im::RedisClientFactory::create(
        FLAGS_ip, FLAGS_port, FLAGS_db, FLAGS_keep_alive);

    // session_test(client);
    // status_test(client);
    code_test(client);

    return 0;
}

3.2 编译与运行

Makefile 配置:

复制代码
all : main

main : main.cc
	g++ -std=c++17 $^ -o $@ -lhiredis -lredis++ -lgflags

.PHONY : clean
clean:
	rm -rf main

运行预期结果:

  • 会话测试:输出用户ID1和用户ID4,中间两个删除了查不到
  • 状态测试:输出用户1在线、用户3在线,用户2删了不显示
  • 验证码测试:前半段输出验证码1和验证码3;等待4秒后输出三个都已过期

如果运行结果和预期一致,说明三个模块的增删查、过期机制全部正常工作。

3.3 常见踩坑

  1. 连接失败:先确认Redis服务是否启动,地址端口是否正确,有没有设置密码(有密码要额外配置password)
  2. 编译报错找不到头文件:redis++和hiredis的头文件要正确安装,确保include路径能找到
  3. 运行崩溃:90%都是OptionalString没判空直接解引用导致的,一定要养成先判断再取值的习惯
  4. 过期时间单位错:set的过期参数默认是毫秒,不要当成秒来传,不然过期时间会差1000倍

四、核心要点总结

  1. 数据分层存储是后端基本素养:核心持久化数据放MySQL,临时高频、带生命周期的数据放Redis,各司其职,性能和成本都最优。不要什么数据都塞MySQL,也不要什么都放Redis。
  2. 按业务拆分管理类:不要把所有Redis操作都揉在一个大类里。会话、状态、验证码各管各的,职责单一,后续维护和扩展都方便,也符合开闭原则。
  3. Optional类型是高频踩坑点:redis++的get返回OptionalString,不是原生string,空值解引用直接崩溃。这是新手用redis++必踩的坑,取值前一定要先判空。
  4. 验证码要做双重失效保障:Redis自动TTL过期 + 校验后手动删除,既保证超时自动失效,又防止同一个验证码被反复提交,安全性更到位。
  5. Redis连接务必复用:不要每次操作都新建连接,TCP连接和认证的开销不小。全局共享一个客户端实例,用连接池或者单例模式,性能会好很多。

结尾:

html 复制代码
🍓 我是草莓熊 Lotso!若这篇技术干货帮你打通了学习中的卡点:
👀 【关注】跟我一起深耕技术领域,从基础到进阶,见证每一次成长
❤️ 【点赞】让优质内容被更多人看见,让知识传递更有力量
⭐ 【收藏】把核心知识点、实战技巧存好,需要时直接查、随时用
💬 【评论】分享你的经验或疑问(比如曾踩过的技术坑?),一起交流避坑
🗳️ 【投票】用你的选择助力社区内容方向,告诉大家哪个技术点最该重点拆解
技术之路难免有困惑,但同行的人会让前进更有方向~愿我们都能在自己专注的领域里,一步步靠近心中的技术目标!

结语:到这里,用户服务的两大核心数据层------MySQL持久化层和Redis缓存层就全部落地了。数据层是业务服务的根基,这两层写稳了,上面的业务逻辑就能专注处理业务,不用被底层数据操作频繁打断。下一篇我们就基于这两个数据层,正式实现用户服务的所有RPC业务接口:注册、登录、验证码、信息修改,把整个用户服务彻底跑通。

✨把这些内容吃透超牛的!放松下吧✨ ʕ˘ᴥ˘ʔ づきらど

相关推荐
西西弗Sisyphus24 分钟前
C++ 里 两个独立的所有权域之间没有建立同步的问题
c++
Flynn Liang1 小时前
AI Agent 分层记忆体系实战:用 Redis 五类结构构建可淘汰、可追溯的长短期记忆
数据库·人工智能·redis
IT规划师2 小时前
Redis 核心机制 | 事务:执行序列的原子性、乐观锁与 8.x 条件写
redis·.net
Henry-SAP11 小时前
PP的生产调度员(Production Scheduler)的角色与配置
数据库
个 人 练 习 生11 小时前
C++:从零基础到深入了解vector的使用
开发语言·c++·经验分享·学习·程序人生·stl
ShineWinsu12 小时前
对于Qt窗口:QMainWindow、QMenuBar、Qmenu、QAction的解析
c++·qt·菜单·qmainwindow·qaction·qmenu·qmenubar
H.莓飛12 小时前
【C++】【STL】stack_OJ题
服务器·c语言·开发语言·数据结构·c++·算法·visual studio
Rabitebla13 小时前
【Linux操作系统】 文件篇(一):文件描述符与 Linux 文件管理机制
linux·网络·c++·笔记·学习