实战演练：在 C 模块中调用 Lua 定义的共享字典数据-Nginx-PHP中文网

C模块可通过OpenResty的ngx_http_lua_shdict接口安全访问Lua定义的shared dict；需在nginx.conf中用lua_shared_dict声明，C代码调用ngx_http_lua_find_zone和ngx_http_lua_shdict_lookup读取数据，仅支持string/number类型，且须在worker进程请求上下文中操作。

实战演练：在 c 模块中调用 lua 定义的共享字典数据

在 OpenResty 环境中，Lua 代码可通过 resty.shared_dict 模块定义和操作共享内存字典（shared dict），而 C 模块（如用 Nginx C API 编写的模块）默认无法直接访问 Lua 的 shared dict。但通过 OpenResty 提供的 lua-resty-core 和底层 C API 集成机制，C 模块可以安全、高效地读取 Lua 定义的共享字典数据——关键在于复用 Nginx 内核的 ngx_http_upstream_shm_zone_t 机制，并借助 OpenResty 的 Lua VM 共享上下文完成绑定。

确认共享字典已在 Lua 层正确定义

Shared dict 必须由 Lua 层（通常是 init_by_lua* 或 http {} 块中的 lua_shared_dict 指令）预先声明，C 模块才能访问其底层共享内存区域：

必须使用 lua_shared_dict my_dict 10m; 在 nginx.conf 中声明，不能仅靠 Lua 代码动态创建（如 shared = require "resty.core.shdict".new("my_dict") 不会注册到 Nginx 共享内存区）
确保 dict 名称无特殊字符（只允许字母、数字、下划线），且大小写敏感
推荐在 http {} 块中定义，避免因作用域问题导致 C 模块查找不到

在 C 模块中获取并访问 shared dict 的共享内存 zone

C 模块需调用 Nginx 核心函数定位已注册的 shared dict zone，再通过 OpenResty 的辅助宏安全读取数据：

使用 ngx_shared_memory_add() 注册时同名的 shm_zone 可通过 ngx_cycle->shared_memory 链表遍历查找，或更可靠地：调用 ngx_http_lua_find_zone()（来自 ngx_http_lua_util.h）传入 dict 名字获取 ngx_http_lua_shdict_ctx_t *
OpenResty 的 ngx_http_lua_shdict_ctx_t 封装了底层 ngx_slab_pool_t * 和哈希表结构，支持原子读写；C 模块应使用其提供的 ngx_http_lua_shdict_lookup() 查找 key，再用 ngx_http_lua_shdict_get_str_value() 或 ngx_http_lua_shdict_get_num_value() 提取值
注意：所有操作必须在 worker 进程上下文中进行，不可在 master 进程或 init 阶段调用（此时 slab 尚未初始化）

典型 C 调用示例（简化版）

以下伪代码展示如何在 handler 钩子中读取名为 cache_dict 的 shared dict 中的字符串值：

包含必要头文件：#include "ngx_http_lua_common.h"、"ngx_http_lua_shdict.h"

在处理函数中：

ngx_http_lua_shdict_ctx_t *ctx;
ngx_str_t dict_name = ngx_string("cache_dict");
ngx_str_t key = ngx_string("user:123");
ngx_str_t value;

ctx = ngx_http_lua_find_zone(r->connection->log, &dict_name);
if (!ctx || !ctx->shpool) {
    return NGX_ERROR; // 字典未找到或未就绪
}

if (ngx_http_lua_shdict_lookup(ctx, &key, &value, NULL) == NGX_OK) {
    // value.data/value.len 即为 Lua 中 set("user:123", "Alice") 存入的值
    ngx_log_debug1(NGX_LOG_DEBUG_HTTP, r->connection->log, 0,
                   "shared dict get: %V", &value);
}

注意事项与避坑指南

实际集成中易出现以下问题，需提前规避：

版本兼容性：ngx_http_lua_shdict_* 接口在 OpenResty 1.19.3.2+ 中稳定公开，旧版本需自行解析 ngx_http_lua_shdict_node_t 结构，不推荐
数据类型限制：C 模块只能读取 Lua 以 string/number 类型存入的数据；table、function、cdata 等复杂类型无法直接还原，Lua 层应统一序列化为 JSON 或 msgpack 字符串
生命周期管理：shared dict 数据由 slab 分配器管理，C 模块无需 free；但 value 字符串指针指向共享内存，不可长期缓存或跨请求复用，应在当前请求周期内使用完毕
并发安全：OpenResty 的 shdict 实现本身是多 worker 安全的，C 模块调用其封装接口即自动获得原子性保障，无需额外加锁