使用Bash进程替换执行nginx -t配置测试失败问题咨询

问题现象 #

直接指定配置文件路径测试成功：

root@bullseye:~# nginx -t -c /etc/nginx/nginx.conf 
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

使用Bash进程替换时测试失败，尽管内容哈希完全一致：

root@bullseye:~# nginx -t -c <(cat /etc/nginx/nginx.conf)
nginx: the configuration file /dev/fd/63 syntax is ok
nginx: [emerg] no "events" section in configuration
nginx: configuration file /dev/fd/63 test failed

内容哈希验证一致：

root@bullseye:~# shasum <(cat /etc/nginx/nginx.conf)
763785a03e17b77057fa782502950930d1206896  /dev/fd/63
root@bullseye:~# shasum /etc/nginx/nginx.conf 
763785a03e17b77057fa782502950930d1206896  /etc/nginx/nginx.conf

原因解析 #

Nginx在解析配置文件时，需要文件支持随机读取（seek操作），而Bash进程替换生成的/dev/fd/63本质是匿名管道（pipe）——管道是单向流，只能顺序读取一次，无法进行seek回退或重复读取。

当Nginx测试配置时，会先完成语法检查（此时已读取完管道内容），后续进行配置有效性验证时，会尝试重新读取文件内容，但管道此时已无数据可读，导致Nginx误判配置缺失events段等关键内容，最终测试失败。

而直接指定常规文件路径时，文件是可seek的，Nginx可以多次读取文件的不同部分，正常完成配置测试流程。

解决方案 #

如果需要通过临时修改的内容测试Nginx配置，可绕过进程替换的限制：

• 将修改后的内容写入临时文件，再指定该文件路径测试：

  # 示例：假设用sed修改配置后写入临时文件
  cat /etc/nginx/nginx.conf | sed 's/old_config/new_config/' > /tmp/test_nginx.conf
  nginx -t -c /tmp/test_nginx.conf
  rm /tmp/test_nginx.conf
  

• 使用mktemp生成安全的临时文件：

  tmpfile=$(mktemp)
  cat /etc/nginx/nginx.conf > "$tmpfile"
  nginx -t -c "$tmpfile"
  rm "$tmpfile"
  

内容的提问来源于stack exchange，提问作者Dick Visser