Nginx配置自定义root仍显示默认欢迎页 疑似fastcgi_params缺失求助

1 优先排查端口匹配问题 #

你当前配置的server块监听端口为8080，默认访问localhost会走HTTP协议默认的80端口，此时请求会匹配Nginx内置的默认80端口站点，自然返回官方欢迎页。

• 临时验证：直接访问http://localhost:8080，查看是否返回你预期的站点内容
• 永久修改：将配置中listen 8080;改为listen 80;，即可通过默认localhost直接访问

2 缺失fastcgi_params文件的解决方法 #

Homebrew安装的Nginx配置类文件默认存放在/opt/homebrew/etc/nginx/目录下，并非二进制文件所在的/opt/homebrew/bin目录，优先到该路径下查找fastcgi_params文件。
如果确认文件不存在，可以手动在/opt/homebrew/etc/nginx/目录下创建fastcgi_params文件，写入以下标准内容即可：

fastcgi_param  QUERY_STRING       $query_string;
fastcgi_param  REQUEST_METHOD     $request_method;
fastcgi_param  CONTENT_TYPE       $content_type;
fastcgi_param  CONTENT_LENGTH     $content_length;

fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
fastcgi_param  REQUEST_URI        $request_uri;
fastcgi_param  DOCUMENT_URI       $document_uri;
fastcgi_param  DOCUMENT_ROOT      $document_root;
fastcgi_param  SERVER_PROTOCOL    $server_protocol;
fastcgi_param  REQUEST_SCHEME     $scheme;
fastcgi_param  HTTPS              $https if_not_empty;

fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;

fastcgi_param  REMOTE_ADDR        $remote_addr;
fastcgi_param  REMOTE_PORT        $remote_port;
fastcgi_param  SERVER_ADDR        $server_addr;
fastcgi_param  SERVER_PORT        $server_port;
fastcgi_param  SERVER_NAME        $server_name;

# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param  REDIRECT_STATUS    200;

创建完成后将你配置中两处引用fastcgi_params的路径统一改为include /opt/homebrew/etc/nginx/fastcgi_params;即可。

3 不必要的配置清理 #

你配置中/devices/和/surveyapp/两个location块使用的是proxy_pass反向代理，不需要引入fastcgi相关配置，直接删除这两个块里的include fastcgi_params;语句即可，避免多余的配置报错。

4 配置生效验证步骤 #

所有修改完成后执行以下操作确保配置生效：

1. 执行nginx -t测试配置语法是否正确，返回success再进行下一步
2. 执行nginx -s reload重载Nginx配置
3. 如果修改了监听端口，执行brew services restart nginx重启Nginx服务
4. 清除浏览器缓存后重新访问站点，验证是否符合预期

额外排查点 #

如果修改后仍有问题，先暂时注释配置末尾的include servers/*;语句，再重载配置测试，避免该目录下的其他站点配置优先级更高，覆盖你当前的server块规则。

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