Nginx 中怎么使用 check 模块在源码编译阶段进行单元测试-Nginx-PHP中文网

nginx 官方无内置单元测试框架，也不含 check 模块；所谓“check 模块”实为第三方 nginx_upstream_check_module，用于 upstream 主动健康检查，非单元测试工具。

nginx 中怎么使用 check 模块在源码编译阶段进行单元测试

Nginx 本身不内置单元测试框架，官方源码中也没有 check 模块这个标准组件。你提到的 “check 模块” 很可能是指第三方健康检查模块 —— nginx_upstream_check_module（常简称为 upstream_check_module 或 nginx-check），它用于为 upstream 组提供主动健康检查功能（如定期发 HTTP HEAD 请求探测后端是否存活）。

⚠️ 需要明确一点：
该模块不提供、也不参与 Nginx 源码编译阶段的“单元测试”。它是一个功能扩展模块，作用是增强 upstream 的高可用能力，和单元测试（unit test）在目的、机制、执行时机上完全不同。

下面分两部分帮你理清：

? 1. `nginx_upstream_check_module` 是什么？怎么用？

这是一个由淘宝（Tengine 团队）开源的第三方模块，用于给 upstream 块添加主动健康检查能力（类似 HAProxy 的 health check）。

✅ 编译启用方式（非单元测试）

# 下载 Nginx 源码（例如 nginx-1.24.0）
# 下载 check 模块（注意版本兼容性，推荐匹配 Nginx 主版本）
git clone https://github.com/yaoweibin/nginx_upstream_check_module.git

# 编译时加入模块（--add-module=路径）
./configure \
  --add-module=/path/to/nginx_upstream_check_module \
  --prefix=/usr/local/nginx \
  ... # 其他配置项

make && make install

✅ 配置示例（启用健康检查）

upstream backend {
    server 192.168.1.10:8080;
    server 192.168.1.11:8080;

    # 启用主动检查
    check interval=3 rise=2 fall=5 timeout=1 type=http;
    check_http_send "HEAD /health HTTP/1.0\r\n\r\n";
    check_http_expect_alive http_2xx http_3xx;
}

server {
    location /status {
        check_status;  # 提供检查状态页（需搭配模块提供的指令）
    }
}

? 注意：check_status 指令仅在启用模块且配置了 check 后才生效；访问 /status 可查看各后端节点的实时健康状态。

Nginx Hosting
通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

? 2. Nginx 源码有单元测试吗？怎么运行？

Nginx 官方没有提供传统意义上的单元测试套件（如 pytest / gtest），但提供了：

回归测试框架（tests/ 目录）：基于 Perl 脚本（t/ 下的 .t 文件），模拟 HTTP 请求/响应，验证配置解析、模块行为、协议处理等。
这些测试属于集成/功能测试层级，不是 C 函数级单元测试。

✅ 运行 Nginx 自带测试的方法：

# 进入 Nginx 源码目录
cd nginx-1.24.0

# 确保已安装 Perl 和 Test::Nginx（常用模块）
cpan Test::Nginx

# 运行全部测试（需先编译，不需要 install）
make
prove -r tests/

# 或只跑某类测试，例如：
prove tests/t/http/headers.t