Nginx配置使用环境变量启动报错，求问题排查方案

错误原因 #

1. 变量配置错误
   你将端口变量${WEB_SERVER_PORT}错误配置在server_name字段中——server_name用于设置域名（如localhost），而非端口。这种误用导致Nginx解析时将变量字符串当作主机名，触发“host not found”错误，错误日志的行号提示可能是模板渲染时的意外异常导致。

2. 镜像未正确关联
   你编写了自定义Dockerfile，但docker-compose.yml直接使用官方nginx镜像，未加载你自定义的镜像配置（删除默认default.conf、复制自定义nginx.conf），导致这些配置完全不生效。

3. 环境变量未定义
   Nginx官方镜像的模板变量替换依赖已定义的环境变量，若未在docker-compose.yml中声明WEB_SERVER_PORT、WEB_SERVER_DOCUMENT_ROOT等变量，模板中的${变量名}会原封不动保留，Nginx无法识别这种格式的主机/端口配置。

修复步骤 #

1. 修正Nginx模板文件 #

调整变量的使用位置，给变量添加默认值避免未定义时出错：

server {
    listen ${WEB_SERVER_PORT:-80};
    server_name ${WEB_SERVER_NAME:-localhost};
    index index.php index.html;
    error_log /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
    root ${WEB_SERVER_DOCUMENT_ROOT:-/usr/share/nginx/html};

    location / {
        try_files $uri /index.php$is_args$args;
    }

    location ~ \.php {
        try_files $uri =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param SCRIPT_NAME $fastcgi_script_name;
        fastcgi_index index.php;
        fastcgi_pass php:${PHP_PORT:-9000};
    }
}

确保模板文件命名为default.conf.template，放在./docker/nginx/templates目录下。

2. 调整Docker Compose配置 #

关联自定义镜像并定义所需环境变量：

web:
  build: .
  volumes:
    - ./docker/nginx/templates:/etc/nginx/templates
  environment:
    - WEB_SERVER_PORT=80
    - WEB_SERVER_NAME=localhost
    - WEB_SERVER_DOCUMENT_ROOT=/usr/share/nginx/html
    - PHP_PORT=9000

3. 重新构建并启动 #

执行以下命令更新镜像并启动服务：

docker-compose build
docker-compose up

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