hiredis连接Redis失败时，先确认redis-server运行及监听地址端口匹配，用redis-cli测试连通性；注意IPv6需特殊配置；连接后必查context->err；操作reply前须校验type并及时释放；异步模式需严格控制调用顺序；链接错误需检查pkg-config输出并确保库链接顺序正确。
hiredis 连接 Redis 失败，redisConnect 返回 NULL 怎么查？
绝大多数连接失败不是代码写错了，而是网络或服务没起来。先确认 redis-server 确实在跑，且监听地址和端口跟代码里传给 redisConnect 的一致。
- 用
redis-cli -h 127.0.0.1 -p 6379 ping手动测试连通性；如果失败，redisConnect必然返回NULL -
redisConnect默认只支持 IPv4，若 Redis 绑定在::1（IPv6），得显式用redisConnectWithTimeout+struct sockaddr_in6，但更简单的是改 Redis 配置：把bind 127.0.0.1加上，或删掉bind行让其监听所有接口 - 连接后务必检查
context->err：即使redisConnect不返回NULL，也可能因认证失败、OOM 等原因处于错误状态，此时context->err非零，context->errstr有具体提示
执行 redisCommand 后取不到返回值，reply 是 NULL 或类型不对
hiredis 的 redisReply 结构体必须按类型安全访问，直接读 reply->str 而不检查 reply->type 是最常见崩溃源。
- 命令出错时（比如语法错、key 不存在），Redis 仍会返回
REDIS_REPLY_ERROR类型的 reply，reply->str指向错误信息，不是空指针——但你不能当成字符串直接用strlen或printf，得先判reply->type == REDIS_REPLY_ERROR -
GET返回REDIS_REPLY_STRING，LRANGE返回REDIS_REPLY_ARRAY，EXISTS返回REDIS_REPLY_INTEGER；类型错配会导致段错误或乱码 - 别忘了
freeReplyObject(reply)：每次redisCommand分配的redisReply*都要手动释放，否则内存泄漏；但redisCommand内部失败时可能根本没分配 reply，所以释放前加if (reply) freeReplyObject(reply);
为什么 redisAppendCommand + redisGetReply 比 redisCommand 更难写对？
这是 hiredis 的异步模式，适合高吞吐场景，但要求严格控制调用顺序和上下文生命周期，新手容易在连接断开或超时时卡死。
-
redisAppendCommand只把命令写入输出缓冲区，不发包；必须紧接着调用redisGetReply才真正收响应——中间如果混入其他 I/O 或线程切换，可能拿到上一条命令的 reply -
redisGetReply是阻塞的，如果 Redis 没响应（比如网络中断、服务宕机），它会一直等，除非提前设置context->timeout（通过redisSetTimeout） - 异步模式下，
redisFree会自动 flush 缓冲区并关闭 socket，但如果还有未redisGetReply的 pending 命令，这些 reply 就永远拿不到了，变成资源泄露
编译链接 hiredis 时提示 undefined reference 到 redisConnect 或 redisFree
不是头文件没包含，是链接阶段漏了库。hiredis 是纯 C 库，没有 C++ name mangling 问题，但链接器找不到符号说明没连上 libhiredis。
立即学习“C++免费学习笔记（深入）”；
- 确保 pkg-config 可用：
pkg-config --libs hiredis应输出类似-lhiredis；g++ 命令末尾加上这个输出结果 - 静态链接时注意顺序：目标文件必须在
-lhiredis之前，比如g++ main.cpp -lhiredis正确，g++ -lhiredis main.cpp会失败 - macOS 上用 Homebrew 安装的 hiredis，默认头文件在
/opt/homebrew/include，库在/opt/homebrew/lib，需显式加-I/opt/homebrew/include -L/opt/homebrew/lib
hiredis 本身不处理连接池、重试、密码加密这些事，所有异常路径都得自己兜底。最常被忽略的是：Redis 断连后 context 不会自动重连，redisCommand 直接返回 NULL，而很多人只检查 reply 是否为空，却忘了再查 context->err 是否为 REDIS_ERR_IO。
