c++如何连接Redis数据库_c++ hiredis库使用教程【数据库】

冰火之心 2025-12-15 00:00:00 次阅读

最常用、最轻量、官方推荐的C++连接Redis方式是使用hiredis库；需源码编译安装，手动管理redisContext和redisReply内存，建议封装RAII类并处理异常与连接池。

要用 C++ 连接 Redis，最常用、最轻量、官方推荐的方式是使用 hiredis —— 它是 Redis 官方维护的 C 语言客户端库，C++ 可直接调用（需注意 C 风格接口和内存管理）。

安装 hiredis

Linux/macOS 下推荐从源码编译安装，确保版本较新（如 v1.2.0+）：

克隆仓库：git clone https://github.com/redis/hiredis.git
进入目录并编译：make && sudo make install
默认头文件装到 /usr/local/include/hiredis/，库文件到 /usr/local/lib/libhiredis.a（或 .so）
若用 CMake，记得在 CMakeLists.txt 中添加：find_package(hiredis REQUIRED) 或手动指定路径

基础连接与命令执行

hiredis 是纯 C 接口，没有 RAII 封装，需手动管理 redisContext* 和 redisReply*：

用 redisConnect() 连接（支持 host/port 或 unix socket）；检查 c->err 判断是否成功
用 redisCommand() 发送命令，返回 redisReply*；必须调用 freeReplyObject() 释放 reply
连接断开或超时后，redisContext 不可重用，需重新 connect

示例片段：

redisContext *c = redisConnect("127.0.0.1", 6379);
if (c == nullptr || c->err) {
    fprintf(stderr, "Connection error: %s\n", c ? c->errstr : "Unknown");
    return -1;
}
redisReply *r = (redisReply*)redisCommand(c, "SET %s %s", "mykey", "hello");
if (r && r->type == REDIS_REPLY_STATUS && strcmp(r->str, "OK") == 0) {
    printf("SET success\n");
}
freeReplyObject(r);
redisFree(c); // 必须调用

处理不同返回类型

redisReply 的 type 字段决定如何取值，常见类型有：

REDIS_REPLY_STRING → 读 r->str（注意：不保证以 \0 结尾，可用 r->len）
REDIS_REPLY_INTEGER → 读 r->integer
REDIS_REPLY_ARRAY → 遍历 r->element[i]，每个仍是 redisReply*
REDIS_REPLY_NIL → 表示空值（如 GET 一个不存在的 key）
REDIS_REPLY_ERROR → 错误响应，读 r->str 获取错误信息

进阶建议：封装与异常安全

裸用 hiredis 易出错（忘记 free、未检查 reply 类型、连接异常未重试）。实际项目中建议：

写一个简单的 RAII 封装类（如 RedisClient），构造时 connect，析构时 redisFree
对 redisCommand 做薄封装，自动 freeReplyObject，并抛出异常或返回 std::optional 处理 NIL/ERROR
需要高并发时，避免共享单个 context；可用连接池（如基于 std::queue + std::mutex 管理多个 context）
如需异步/管道操作，启用 hiredis 的 async 模式（配合 libevent 或 libuv），但 C++ 项目中更推荐用 modern-cpp-redis（基于 hiredis 的现代 C++ 封装）替代

基本上就这些。hiredis 本身不复杂，但细节（比如 reply 内存归属、连接生命周期）容易忽略。用熟之后，它稳定、高效、无依赖，是 C++ 操作 Redis 的可靠选择。