Nginx 支持 set-misc-nginx-module 必须在编译时静态集成，依赖 ngx_devel_kit 模块，需下载 v0.3.3 NDK 和 v0.33 set-misc，通过 --add-module 指定路径重新编译安装，并用 nginx -V 和 nginx -t 验证生效。
要让 Nginx 支持 set-misc-nginx-module，不能通过配置文件直接“开启”，它必须在编译阶段静态集成进 Nginx 二进制程序中。该模块不支持运行时动态加载（.so 方式），所以核心动作是重新编译 Nginx。
确认依赖模块已准备就绪
该模块有硬性依赖：ngx_devel_kit（NDK）。两者必须同时加入编译，顺序无关但缺一不可：
-
ngx_devel_kit：提供底层开发接口，是多数 OpenResty 相关模块的基础 -
set-misc-nginx-module：基于 NDK 实现变量操作、编码/解码、SQL/JSON 转义等指令
建议使用稳定版本组合，例如：
- NDK：
v0.3.2或v0.3.3 - set-misc：
v0.33（最新兼容主流 Nginx 1.20+）
下载并解压模块源码
在编译环境（如 /opt/nginx-modules）中执行：
wget https://github.com/vision5/ngx_devel_kit/archive/refs/tags/v0.3.3.tar.gz -O ndk.tar.gz<br>wget https://github.com/openresty/set-misc-nginx-module/archive/refs/tags/v0.33.tar.gz -O set-misc.tar.gz<br>tar -zxf ndk.tar.gz -C /opt/nginx-modules/<br>tar -zxf set-misc.tar.gz -C /opt/nginx-modules/
解压后目录结构应类似：/opt/nginx-modules/ngx_devel_kit-0.3.3 和 /opt/nginx-modules/set-misc-nginx-module-0.33。
重新编译 Nginx 并启用模块
进入你的 Nginx 源码目录（如 nginx-1.22.1），执行 configure 并显式添加两个模块路径：
./configure \<br> --prefix=/usr/local/nginx \<br> --add-module=/opt/nginx-modules/ngx_devel_kit-0.3.3 \<br> --add-module=/opt/nginx-modules/set-misc-nginx-module-0.33 \<br> [其他你原有需要的模块，如 --with-http_ssl_module 等]
之后执行：
make && sudo make install
编译成功后，可通过以下命令验证模块是否生效：
/usr/local/nginx/sbin/nginx -V 2>&1 | grep -o 'set-misc'
若输出 set-misc，说明已集成；再检查指令是否存在：
/usr/local/nginx/sbin/nginx -t
只要配置中用了 set_if_empty、set_unescape_uri 等指令且语法正确，就不会报错。
在配置中安全使用典型指令
模块生效后，可在 location 或 location if 块中使用其指令。注意作用域限制：
-
set_if_empty $a "default";：仅当$a为空字符串或未定义时赋值 -
set_unescape_uri $decoded $arg_url;：对查询参数url=xxx做 URI 解码 -
set_quote_json_str $quoted $raw;：将变量内容转为合法 JSON 字符串（自动加双引号、转义特殊字符）
⚠️ 不要在 if 外的全局块（如 http 或 server）直接使用这些 set_* 指令，会报错。
