
🔥草莓熊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 常见踩坑
- 连接失败:先确认Redis服务是否启动,地址端口是否正确,有没有设置密码(有密码要额外配置password)
- 编译报错找不到头文件:redis++和hiredis的头文件要正确安装,确保include路径能找到
- 运行崩溃:90%都是OptionalString没判空直接解引用导致的,一定要养成先判断再取值的习惯
- 过期时间单位错:set的过期参数默认是毫秒,不要当成秒来传,不然过期时间会差1000倍
四、核心要点总结
- 数据分层存储是后端基本素养:核心持久化数据放MySQL,临时高频、带生命周期的数据放Redis,各司其职,性能和成本都最优。不要什么数据都塞MySQL,也不要什么都放Redis。
- 按业务拆分管理类:不要把所有Redis操作都揉在一个大类里。会话、状态、验证码各管各的,职责单一,后续维护和扩展都方便,也符合开闭原则。
- Optional类型是高频踩坑点:redis++的get返回OptionalString,不是原生string,空值解引用直接崩溃。这是新手用redis++必踩的坑,取值前一定要先判空。
- 验证码要做双重失效保障:Redis自动TTL过期 + 校验后手动删除,既保证超时自动失效,又防止同一个验证码被反复提交,安全性更到位。
- Redis连接务必复用:不要每次操作都新建连接,TCP连接和认证的开销不小。全局共享一个客户端实例,用连接池或者单例模式,性能会好很多。
结尾:
html
🍓 我是草莓熊 Lotso!若这篇技术干货帮你打通了学习中的卡点:
👀 【关注】跟我一起深耕技术领域,从基础到进阶,见证每一次成长
❤️ 【点赞】让优质内容被更多人看见,让知识传递更有力量
⭐ 【收藏】把核心知识点、实战技巧存好,需要时直接查、随时用
💬 【评论】分享你的经验或疑问(比如曾踩过的技术坑?),一起交流避坑
🗳️ 【投票】用你的选择助力社区内容方向,告诉大家哪个技术点最该重点拆解
技术之路难免有困惑,但同行的人会让前进更有方向~愿我们都能在自己专注的领域里,一步步靠近心中的技术目标!
结语:到这里,用户服务的两大核心数据层------MySQL持久化层和Redis缓存层就全部落地了。数据层是业务服务的根基,这两层写稳了,上面的业务逻辑就能专注处理业务,不用被底层数据操作频繁打断。下一篇我们就基于这两个数据层,正式实现用户服务的所有RPC业务接口:注册、登录、验证码、信息修改,把整个用户服务彻底跑通。
✨把这些内容吃透超牛的!放松下吧✨ ʕ˘ᴥ˘ʔ づきらど
