C++连接Redis方法及hiredis使用教程

使用hiredis库可高效实现C++与Redis交互。首先安装libhiredis-dev或hiredis-devel，再通过redisConnect连接Redis服务器，调用redisCommand执行SET、GET等命令，操作字符串、列表等数据类型，并用freeReplyObject释放响应结果，最后redisFree断开连接。编译时需链接-hiredis。

在C++中连接和操作Redis数据库，最常用的方式是使用官方推荐的C客户端库 hiredis。由于Redis本身是用C语言编写的，hiredis轻量高效，被广泛用于C/C++项目中的NoSQL数据交互。

安装 hiredis 库

在开始前，需要先安装 hiredis 动态库和头文件。以 Ubuntu/Debian 系统为例：

sudo apt-get update
sudo apt-get install libhiredis-dev

如果你使用的是 CentOS 或 Fedora：

sudo yum install hiredis-devel

也可以从 GitHub 源码编译安装：

git clone https://github.com/redis/hiredis.git
cd hiredis
make
sudo make install
sudo ldconfig  // 刷新共享库缓存


编写 C++ 程序连接 Redis
使用 hiredis 连接 Redis 非常简单。以下是一个基本的同步连接示例，展示如何设置键值、获取值并处理响应。


#include 
#include 

int main() {
    // 1. 连接 Redis 服务器
    redisContext *context = redisConnect("127.0.0.1", 6379);
    if (context == nullptr || context->err) {
        if (context) {
            std::cerr << "连接错误: " << context->errstr << std::endl;
        } else {
            std::cerr << "无法分配 redis context" << std::endl;
        }
        return -1;
    }

    std::cout << "成功连接到 Redis 服务器！" << std::endl;

    // 2. 执行 SET 命令
    redisReply *reply = (redisReply*)redisCommand(context, "SET mykey 'Hello from C++'");
    if (reply == nullptr) {
        std::cerr << "执行命令失败: " << context->errstr << std::endl;
        redisFree(context);
        return -1;
    }
    std::cout << "SET 命令执行结果: " << reply->str << std::endl;
    freeReplyObject(reply);

    // 3. 执行 GET 命令
    reply = (redisReply*)redisCommand(context, "GET mykey");
    if (reply != nullptr && reply->type == REDIS_REPLY_STRING) {
        std::cout << "GET mykey 的值: " << reply->str << std::endl;
    } else {
        std::cout << "键不存在或返回类型错误" << std::endl;
    }
    freeReplyObject(reply);

    // 4. 断开连接
    redisFree(context);
    return 0;
}



编译与运行
编译时需要链接 hiredis 库：

g++ -o redis_demo redis_demo.cpp -lhiredis


确保 Redis 服务正在运行：

redis-server --daemonize yes


然后运行程序：

./redis_demo


输出应为：

成功连接到 Redis 服务器！
SET 命令执行结果: OK
GET mykey 的值: Hello from C++



处理复杂数据类型与异常
Redis 支持多种数据结构，如列表、哈希、集合等。你可以通过发送相应的命令来操作它们。
例如，向列表添加元素并读取：

// 添加元素到列表
reply = (redisReply*)redisCommand(context, "LPUSH mylist 'item1'");
freeReplyObject(reply);

reply = (redisReply*)redisCommand(context, "LPUSH mylist 'item2'");
freeReplyObject(reply);

// 获取列表长度
reply = (redisReply*)redisCommand(context, "LLEN mylist");
if (reply->type == REDIS_REPLY_INTEGER) {
    std::cout << "列表长度: " << reply->integer << std::endl;
}
freeReplyObject(reply);

// 获取所有元素
reply = (redisReply*)redisCommand(context, "LRANGE mylist 0 -1");
if (reply->type == REDIS_REPLY_ARRAY) {
    for (size_t i = 0; i < reply->elements; ++i) {
        std::cout << "元素 " << i << ": " << reply->element[i]->str << std::endl;
    }
}
freeReplyObject(reply);


注意判断 reply->type 类型，避免空指针或类型不匹配导致崩溃。

异步操作（可选进阶）
hiredis 还提供异步 API（hiredis async），适用于高并发场景。它基于事件循环，可与 libevent、libev 等集成，实现非阻塞通信。
对于大多数中小型应用，同步接口已足够高效。

基本上就这些。掌握 hiredis 后，C++ 与 Redis 的交互变得直接而高效。