Windows10环境Nginx部署Laravel项目API路由返回404错误问题求助

DevOps 小满

2026-10-11

问题根源

404错误由Nginx路由规则配置错误导致：当前配置会将匹配不到真实文件/目录的请求直接返回404，没有转发给Laravel的入口文件index.php处理，因此Laravel的路由规则无法生效。

需调整的配置项

修正location /块的try_files规则，将找不到对应资源的请求转发到index.php，同时携带请求参数
修正location ~ \.php$块中try_files规则的语法错误（等号与404之间不能有空格）

修正后的完整Nginx配置

server {
    listen 80 ;
    listen [::]:80 ;

    root D:/sites/demo/public;
    index index.php index.html index.htm ;

    server_name laravel.local;

    location / {
        # 核心修改：匹配不到路径时转发给index.php处理，携带query参数
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        # 修正语法错误，去掉=和404之间的空格
        try_files $uri /index.php =404;
        fastcgi_pass   127.0.0.1:9123;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }

    location ~ /\.ht {
            deny all;
    }
}