Laravel 移除 URL 斜杠并实现 301 重定向方法

本文深入剖析 Laravel 中移除 URL 末尾斜杠并实现精准 301 重定向的核心难题，直击 `request->fullUrl()` 自动截断斜杠导致中间件失效的隐蔽陷阱，揭示为何依赖该方法判断尾部 `/` 必然失败，并提供基于原始请求 URI（`getRequestUri()`）与 Laravel 原生字符串工具的健壮、可靠解决方案——不仅彻底解决重复 URL 影响 SEO 的痛点，更赋予开发者对 URL 规范化的完全控制力。

本文详解 Laravel 应用中检测并移除 URL 末尾斜杠的可靠方案，解决因 request->fullUrl() 自动截断末尾 / 导致中间件失效的问题，并提供基于 Laravel 原生字符串工具的健壮实现。

本文详解 Laravel 应用中检测并移除 URL 末尾斜杠的可靠方案，解决因 `request->fullUrl()` 自动截断末尾 `/` 导致中间件失效的问题，并提供基于 Laravel 原生字符串工具的健壮实现。

在 SEO 优化实践中，统一 URL 格式（如强制去除末尾斜杠 /）是避免 Google 将 https://example.com/about/ 和 https://example.com/about 视为重复内容的关键措施。许多开发者尝试通过自定义中间件实现自动 301 重定向，但常遇到一个隐蔽陷阱：Laravel 的 $request->fullUrl() 方法在底层会自动规范化 URL——无论浏览器实际请求的是 /about/ 还是 /about，它均返回不带尾部斜杠的版本。这意味着直接使用 substr($request->fullUrl(), -1) === '/' 判断必然失败，中间件形同虚设。

根本原因在于：fullUrl() 内部调用的是 url()->full()，而该方法基于当前请求的 path() 和 query() 构建 URL，并不反映原始请求行（Request-Line）中的完整路径。因此，必须转向更底层、更可靠的判断方式。

✅ 正确方案：使用 request->getRequestUri() + Laravel 字符串辅助函数

应改用 $request->getRequestUri() 获取原始请求 URI（含路径与查询参数），再结合 Laravel 提供的 Illuminate\Support\Str 工具类进行安全判断与截取：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Str;

class NonSlashURL
{
    public function handle(Request $request, Closure $next)
    {
        // 获取原始请求 URI（例如：/content/?ref=home）
        $uri = $request->getRequestUri();

        // 检查 URI 是否以 '/' 结尾（排除查询参数干扰，仅关注路径结尾）
        if (Str::endsWith($uri, '/')) {
            // 安全移除最后一个 '/' —— 即使 URI 为 '/' 也只移除一个
            $trimmedUri = Str::beforeLast($uri, '/');
            // 构造完整重定向 URL：协议 + 域名 + 处理后的 URI
            $redirectUrl = $request->getSchemeAndHttpHost() . $trimmedUri;
            return redirect($redirectUrl, 301);
        }

        return $next($request);
    }
}

? 关键点说明：

• getRequestUri() 返回原始请求路径+查询字符串（如 /blog/ 或 /api/users/?page=2），真实反映用户输入；
• Str::endsWith() 比 substr(..., -1) 更语义化且可读性更强；
• Str::beforeLast() 精准移除最后一个 /，避免误删路径中其他 /（如 /admin/posts/ → /admin/posts），比 rtrim($uri, '/') 更安全（后者对 / 会返回空字符串）；
• 使用 $request->getSchemeAndHttpHost() 动态拼接重定向 URL，确保协议（HTTP/HTTPS）、端口（如需）、域名完全一致，避免硬编码导致的跨环境问题。

⚠️ 注意事项与最佳实践

• 注册中间件：将该中间件注册为全局中间件（app/Http/Kernel.php 中的 $middleware 数组），或按需添加到 $middlewareGroups['web']，确保其在路由解析前执行。
• 避免循环重定向：确保重定向目标 URL 不再匹配本中间件逻辑（即处理后 URI 不再以 / 结尾），上述实现已天然规避此问题。
• 静态资源与 API 路由：若需对部分路由（如 /assets/ 或 /api/）豁免处理，可在中间件内增加白名单判断：

  $excludedPaths = ['/api/', '/storage/', '/vendor/'];
  if (collect($excludedPaths)->first(fn($p) => Str::startsWith($uri, $p))) {
      return $next($request);
  }

• 测试验证：使用 curl -I 或浏览器开发者工具 Network 面板确认响应状态码为 301 Moved Permanently，且 Location 头指向无尾斜杠的正确 URL。

通过此方案，您不仅能精准捕获并重定向带尾斜杠的请求，还能保持代码简洁、健壮且符合 Laravel 最佳实践，从根本上解决 SEO 重复内容隐患。

理论要掌握，实操不能落！以上关于《Laravel 移除 URL 斜杠并实现 301 重定向方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！