nginx模块初始化错误不写入error_log，因其发生在日志系统初始化前；应使用nginx -c conf -e stderr捕获stderr输出，并结合nginx -v、-t等命令核验模块编译、加载及配置上下文。
Nginx 模块初始化错误不会写入 error_log 文件，因为这类错误发生在日志系统初始化之前——配置还没完全加载，error_log 指令尚未生效。你看到的 error.log 为空或没有相关报错，不是配置没起作用，而是错误根本没走到那一步。
要真正追踪模块初始化错误，必须绕过日志文件，直接捕获启动早期的原始输出。
? 用 -e stderr 强制终端输出启动期错误
这是最直接、最可靠的手段。Nginx 启动时若因模块缺失、指令未识别、依赖加载失败而中断，这些信息只会发往标准错误（stderr），不会进 error.log。
运行命令：
nginx -c /etc/nginx/nginx.conf -e stderr
常见典型输出：
-
unknown directive "lua_block"→ Lua 模块未编译或未加载 -
failed to initialize Lua VM→ JIT 路径错误、Lua 版本不兼容 -
dlopen() "/path/to/module.so" failed→.so文件路径错误、权限不足或 ABI 不匹配
✅ 提示：若用 systemd 管理服务，先
systemctl stop nginx，再手动运行上述命令，避免被 unit 文件重定向掩盖输出。
? 核验模块是否真被编译进 Nginx 二进制
配置里写了 lua_block，但报 unknown directive，大概率是模块压根没编译进去。
执行：
nginx -V 2>&1 | grep -o with-\S*
检查输出中是否含对应参数，例如：
-
--with-stream（流模块） -
--add-module=/path/to/ngx_http_vts_module（第三方模块）
第三方模块还需确认：
-
load_module指令存在且路径正确，如：load_module modules/ngx_http_vhost_traffic_status_module.so;
-
.so文件真实存在，且 Nginx 运行用户（如nginx或www-data）有读权限 - 路径不含未解析变量或失效软链（建议用绝对路径）
? 用 -T 定位模块指令所在上下文
模块指令是否合法，取决于它所处的配置块层级。比如：
-
vhost_traffic_status_zone必须在http { ... }块内 -
stream { ... }块中的指令不能写在http内 -
load_module必须放在events和http块之外（即全局 main 上下文），且不能被注释
运行：
nginx -T 2>&1 | grep -A 3 -B 3 "vhost_traffic_status_zone"
观察该指令是否出现在合法位置，同时确认 load_module 行确实已加载对应模块。
? 补全日志基础环境，防静默退出
即使加了 -e stderr，如果 error_log 指向的目录不可写，Nginx 可能在打印任何信息前就崩溃退出（尤其在 worker 初始化阶段）。
检查主配置中的 error_log 指令，例如：
error_log /var/log/nginx/error.log error;
然后确保：
- 目录存在：
mkdir -p /var/log/nginx - 权限正确：
chown nginx:nginx /var/log/nginx - 若以非 root 用户测试，该用户需对路径有写权限
否则，-e stderr 是唯一能拿到线索的方式。
不复杂但容易忽略。
