redis 7.0+模块api是唯一可行路径，因6.x缺乏自动内存管理、调试接口和错误码规范；需c++17支持、extern "c"导出符号、正确使用openkey/closekey及redismodule_log调试。
Redis 7.0+ 的 module API 是唯一可行路径
Redis 自 6.0 起支持模块（module），但真正稳定、完整暴露命令扩展能力的是 7.0+ 版本。低于 7.0 的 Redis（比如 6.2）虽有 RedisModule_CreateCommand，但缺乏关键类型支持（如 RedisModuleString 的自动内存管理）、调试接口和错误码规范，实际开发极易触发段错误或内存泄漏。如果你用的是 6.x，请先升级 Redis —— 不是“建议”，是硬性前提。
- 确认版本：
redis-server --version输出必须为Redis server v=7.0.0或更高 - 编译依赖：需启用模块支持，确保 configure 时未禁用
--enable-module（默认开启） - C++ 编译器需支持 C++17（模块头文件
redismodule.h内部使用constexpr和std::string_view等特性）
用 extern "C" 包裹模块入口函数，否则 Redis 加载失败
Redis 的模块加载器只认 C 风格符号。即使整个实现用 C++ 编写，RedisModule_OnLoad 函数也必须以 C 链接方式暴露，否则 MODULE LOAD 会报错 ERR Error loading the extension. No such file or directory（注意：这错误信息极具误导性，实际是符号找不到）。
extern "C" int RedisModule_OnLoad(RedisModuleCtx *ctx, RedisModuleString **argv, int argc) {
if (RedisModule_Init(ctx, "mycounter", 1, REDISMODULE_APIVER_1) == REDISMODULE_ERR)
return REDISMODULE_ERR;
if (RedisModule_CreateCommand(ctx, "counter.incr",
counterIncrCommand,
"write deny-scripts", 1, 1, 1) == REDISMODULE_ERR)
return REDISMODULE_ERR;
return REDISMODULE_OK;
}
- 所有命令回调函数（如
counterIncrCommand）也必须声明为extern "C"或定义在extern "C"块内 - 不要在
RedisModule_OnLoad中调用任何可能抛异常的 C++ 代码（如std::string构造失败），Redis 不捕获 C++ 异常，直接 crash - 模块名（
"mycounter"）不能含下划线或大写字母，否则MODULE LIST显示异常
操作 Redis key 必须用 RedisModule_OpenKey + 类型检查，别直接 cast
新手常犯错误：拿到 RedisModuleString* 就直接传给 std::string 构造，或对 key 调用 RedisModule_StringPtrLen 后强转成 char* 去做 std::map 查找 —— 这完全绕过了 Redis 的内存模型和键空间隔离，导致数据不一致甚至崩溃。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
正确做法是通过 RedisModule_OpenKey 获取 RedisModuleKey*，再用 RedisModule_KeyType 判断类型，最后用对应 API 读写：
int counterIncrCommand(RedisModuleCtx *ctx, RedisModuleString **argv, int argc) {
if (argc != 2) return RedisModule_WrongArity(ctx);
RedisModuleKey *key = RedisModule_OpenKey(ctx, argv[1], REDISMODULE_WRITE);
int type = RedisModule_KeyType(key);
if (type != REDISMODULE_KEYTYPE_STRING && type != REDISMODULE_KEYTYPE_EMPTY) {
RedisModule_CloseKey(key);
return RedisModule_ReplyWithError(ctx, REDISMODULE_ERRORMSG_WRONGTYPE);
}
long long val = 0;
if (type == REDISMODULE_KEYTYPE_STRING) {
RedisModuleString *str;
if (RedisModule_StringToLongLong(key, &val) != REDISMODULE_OK) {
RedisModule_CloseKey(key);
return RedisModule_ReplyWithError(ctx, "ERR value is not an integer");
}
}
val++;
RedisModule_StringSet(key, RedisModule_CreateStringPrintf(ctx, "%lld", val));
RedisModule_CloseKey(key);
RedisModule_ReplyWithLongLong(ctx, val);
return REDISMODULE_OK;
}
-
RedisModule_OpenKey返回的RedisModuleKey*必须配对调用RedisModule_CloseKey，否则 key 句柄泄漏 - 对空 key（
REDISMODULE_KEYTYPE_EMPTY）也要处理，否则INCR类命令无法初始化新 key - 不要用
RedisModule_StringPtrLen获取原始指针去构造std::string，Redis 字符串可能未以\0结尾；要用RedisModule_StringPtrLen+std::string_view或RedisModule_CreateStringPrintf
调试阶段务必启用 Redis 的模块日志，否则几乎无法定位问题
Redis 模块运行在服务端进程内，没有 stdout/stderr，printf 和 std::cout 完全无效。不启用日志，你写的 C++ 逻辑是否执行、在哪一行崩溃、参数是否为空，全部黑盒。
启动 Redis 时加参数：redis-server --loglevel debug --loadmodule ./mymodule.so，然后在客户端执行：CONFIG SET loglevel debug，再用 MODULE LOAD ./mymodule.so。所有 RedisModule_Log 输出都会出现在 Redis 日志中：
RedisModule_Log(ctx, "debug", "counter.incr called with key: %s",
RedisModule_StringPtrLen(argv[1], nullptr));
- 日志级别选
debug，notice级别会过滤掉大部分模块调试信息 - 避免在高频命令（如每秒上万次调用）中打
debug日志，I/O 开销会导致性能骤降 -
RedisModule_Log不支持%s直接传RedisModuleString*，必须先用RedisModule_StringPtrLen转换
std::shared_ptr）若持有这些资源，必须严格遵循模块 API 的释放契约，否则下次 GC 或命令调用就踩内存。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
