Laravel框架下404页面自动重定向至首页的实现方案咨询

方法1：Laravel异常处理器（推荐，覆盖所有404场景） #

Laravel自带的异常处理系统可以直接捕获404错误并完成重定向：

1. 打开项目中的 app/Exceptions/Handler.php 文件
2. 在 register 方法中添加以下代码（记得引入对应的异常类）：

use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

public function register()
{
    $this->renderable(function (NotFoundHttpException $e, $request) {
        return redirect()->to('/');
    });
}

这段代码会捕获所有触发NotFoundHttpException的请求（也就是404错误），直接重定向到网站首页。

方法2：服务器配置（处理静态文件类的404请求） #

如果用户访问的是像product.php这类未实际存在的静态文件，可能不会经过Laravel路由，这时候需要直接修改服务器配置：

Apache环境 #

修改项目根目录的 .htaccess 文件，在Laravel默认Rewrite规则前添加：

# 重定向不存在的PHP文件到首页
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+\.php)$ / [R=301,L]

完整的.htaccess示例：

RewriteEngine On

# 处理PHP文件404重定向
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+\.php)$ / [R=301,L]

# Laravel默认路由规则
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]

Nginx环境 #

在站点配置的server块中添加：

# 所有404错误重定向到首页
error_page 404 /;

如果需要单独处理PHP文件的404，可以添加：

location ~* \.php$ {
    if (!-f $request_filename) {
        return 301 /;
    }
    # 保留原有的fastcgi配置
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    include fastcgi_params;
}

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