答案是：nginx因非法内置变量名启动失败时，需确认变量是否为当前版本官方支持的内置变量、命名合法、使用位置合规，并通过nginx -t和error.log精确定位错误。具体包括核对变量名（如$host、$arg_name）是否在nginx.org官方列表中，区分正则捕获变量（$1）仅限rewrite等上下文使用，避免在不支持处引用（如listen $port），检查第三方模块变量是否已编译启用并正确加载。
遇到 Nginx 因配置中使用了非法内置变量名而启动失败，通常表现为 nginx -t 报错“unknown directive”或“invalid number of arguments”，甚至直接触发 emerg 级错误退出。这类问题不涉及语法拼写（如少分号），而是变量本身未被 Nginx 版本支持、命名不合法，或在错误上下文中被引用。
确认变量是否为官方内置变量
Nginx 只识别以 $ 开头、且名称符合其预定义列表的变量（如 $host、$request_uri、$arg_name）。非标准写法（如 $my_var、$1、$upstream_addr 但未启用 upstream 模块）均会报错。
- 查阅当前 Nginx 版本的官方变量文档（例如：nginx.org/en/docs/varindex.html），核对所用变量是否在列表中
- 注意区分：正则捕获变量（如
$1、$2）只能在rewrite、return、set等支持上下文里使用；在location或server块顶层直接写$1会导致解析失败 -
$args、$query_string是合法的；但$get_params或$url_args这类自造名称一律无效
检查变量使用位置是否合规
即使变量名正确，若放在不支持该变量的指令或作用域中，Nginx 也会拒绝加载配置。
-
root $document_root;合法（$document_root是内置变量）；但user $remote_addr;非法（user指令不接受变量） -
proxy_set_header Host $host;正确；而listen $server_port;错误（listen不支持变量，端口必须为静态数值） - 在
if块内使用$scheme是允许的，但$sent_http_content_type（响应头变量）在请求处理阶段不可用，会触发 “variable is not supported” 类似提示
借助 nginx -t 和错误日志精确定位
nginx -t 是最直接的验证手段，它会在出错行明确指出变量问题。
- 运行
nginx -t -c /path/to/nginx.conf，关注输出中的具体行号和错误描述，例如：nginx: [emerg] invalid variable "$bad_var" in /etc/nginx/conf.d/site.conf:42 - 若提示
unknown directive "$arg_x"，说明 Nginx 误将变量当作了指令名——常见原因是漏写了赋值语句前的指令，比如：$arg_token # 缺少 set / if / rewrite 等前置指令 - 查看
error.log最近几行，搜索关键词variable、invalid、unknown，Nginx 通常会打印变量名及所在文件与行号
验证第三方模块引入的变量是否已启用
某些变量来自扩展模块（如 ngx_http_geoip2_module 的 $geoip2_country_code），它们不是 Nginx 默认内置的。
- 执行
nginx -V 2>&1 | grep -o with-http_geoip2_module，确认编译时已启用对应模块 - 检查配置中是否漏加
load_module指令（如load_module modules/ngx_http_geoip2_module.so;），否则变量无法识别 - 模块变量需配合相应配置块使用（如
geoip2块），单独引用会报错
