“unknown directive”类报错主因是模块未编译进Nginx二进制文件，须先用nginx -V检查with-http_ssl_module、with-stream等参数是否存在；若缺失，则需重新编译或动态加载对应模块，并确保指令语法、上下文及依赖库正确。
遇到“unknown directive”类报错（比如 unknown directive "ssl"、unknown directive "brotli"、unknown directive "stream"），大概率不是写错了单词，而是对应模块根本没编译进 Nginx 二进制文件里。这类问题必须先确认模块是否存在，再排查配置是否合法。
查模块是否已编译进 nginx
这是最常被跳过的一步。很多系统用包管理器安装的 Nginx（如 Ubuntu 的 apt 或 CentOS 的 yum）默认不启用某些模块。
- 运行
nginx -V 2>&1 | grep -o with-http_ssl_module—— 若无输出，说明http_ssl_module没编译 - 同理检查其他模块：
nginx -V | grep brotli、nginx -V | grep stream、nginx -V | grep grpc - 注意：
nginx -V显示的是编译时参数，不是当前运行时加载的模块列表
区分编译缺失和动态加载失败
新版 Nginx（≥1.9.11）支持动态模块，但需手动加载且依赖完整：
- 若用了
load_module modules/ngx_http_brotli_filter_module.so;却报 unknown directive，先检查该.so文件是否存在、路径是否正确 - 运行
ldd /path/to/module.so | grep brotli看是否提示not found——说明底层 libbrotli 运行库缺失 - 动态模块无法替代编译缺失：像
ssl这类核心模块不支持纯动态加载，必须重新编译
验证配置指令是否匹配模块能力
即使模块存在，指令也可能因版本或上下文不合法而报错：
-
ssl on;在 Nginx ≥1.15 中已被彻底移除，必须改用listen 443 ssl; -
stream { }块只能出现在 main 上下文（即 nginx.conf 顶层），不能放在 http 块里 -
brotli on;必须在 http、server 或 location 块中，且前提是模块已启用并配置了brotli_types等配套指令
结合 nginx -t 和 error_log 定位真实原因
nginx -t 是第一道筛子，但它不会告诉你“模块没编译”，只会报“unknown directive”。这时要交叉验证：
- 执行
nginx -t，记下报错的文件与行号 - 立刻查看
error.log最后几行，找带[emerg]的日志，确认是否与-t输出一致 - 如果
-t报错但error.log没新增记录，可能是日志路径被覆盖（如配置里写了error_log /dev/null）或权限不足写不进去 - 若
-t通过，但启动时报类似dlopen() failed，说明是动态模块加载失败，不是语法问题
