NGINX配置问题：访问http://serverip/htdocs/时无法加载index.php报404

这是NGINX配置里很常见的问题，核心是确保你在对应的location块里正确配置了index指令，同时路径映射没有出错。下面给你一步步的解决方案：

1. 检查并修改NGINX配置 #

打开你的NGINX站点配置文件（通常在/etc/nginx/sites-available/下，或者直接编辑/etc/nginx/nginx.conf），找到对应的server块，添加或调整以下配置：

server {
    listen 80;
    server_name 你的服务器IP; # 替换成实际的serverip

    # 处理/htdocs/路径的请求
    location /htdocs/ {
        # 这里的root是htdocs目录的上级目录，比如你的index.php存放在/var/www/htdocs/下，就设为/var/www
        root /var/www;
        # 指定自动加载的索引文件，按顺序查找，找到第一个存在的就返回
        index index.php index.html index.htm;
    }

    # 如果需要支持PHP解析，必须加上这段（根据你的PHP版本调整fastcgi_pass路径）
    location ~ \.php$ {
        root /var/www;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 比如PHP8.0就是php8.0-fpm.sock
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

2. 关键配置说明 #

• index指令：这就是让NGINX自动加载索引文件的核心，它会按你列出的顺序在目标目录里查找文件，比如访问http://serverip/htdocs/时，会先找/var/www/htdocs/index.php，找不到再找index.html，以此类推。
• root vs alias：如果你的htdocs目录实际路径是/home/user/website/htdocs，也可以用alias代替root，写法是alias /home/user/website/htdocs/;，这时候不需要拼上级目录，直接指定实际目录路径即可。两种方式选一种就行，别混用。
• 权限问题：确保NGINX进程（通常是www-data用户）有读取htdocs目录及文件的权限，否则会返回403或404。可以用chown -R www-data:www-data /var/www/htdocs/来设置权限。

3. 验证配置并重启NGINX #

修改完配置后，先测试配置是否合法：

nginx -t

如果输出test is successful，就重启NGINX让配置生效：

systemctl restart nginx

现在再访问http://serverip/htdocs/，应该就能自动加载index.php（如果存在的话）了。

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