Next.js 提供多种方法实现页面重定向,无论您构建的是客户端还是服务器端应用,都能轻松实现页面间的无缝跳转。本指南将介绍几种基于最新文档的 Next.js 重定向方法。
-
使用 redirect() 函数(服务器组件和 API 路由)
Next.js 内置的 redirect() 函数主要用于服务器组件和 API 路由。该函数可立即重定向,无需渲染任何 UI。
import { redirect } from 'next/navigation'; export default function Page() { redirect('/dashboard'); // 重定向到 /dashboard return null; }
关键点:
- 只能在服务器组件或 API 路由中使用。
- 立即停止后续执行并重定向用户。
- 非常适合执行身份验证检查或路由保护。
-
使用 Next.js 配置重定向 (next.config.js)
在 next.config.js 中定义全局重定向,实现服务器级别的自动重定向。
module.exports = { async redirects() { return [ { source: '/旧路由', destination: '/新路由', permanent: true, // 使用 false 表示临时重定向 }, ]; }, };
关键点:
- 框架级别运作。
- 最适合处理 SEO 友好的 301(永久)或 302(临时)重定向。
- 重定向发生在渲染之前,提升性能。
-
客户端使用 next/router 重定向
对于客户端重定向,使用 useRouter() 钩子。这在需要根据用户交互(例如点击按钮)进行重定向时非常有用。
关键点:
- 仅在客户端组件中有效。
- 用于处理由用户交互触发的重定向。
- 使用 router.push() 实现平滑导航,无需全页重新加载。
-
使用中间件重定向
Next.js 中间件允许在请求完成前运行代码,这对于基于条件的动态重定向非常有用。
import { NextResponse } from 'next/server'; export function middleware(req) { const isAuthenticated = false; // 请替换为实际的身份验证检查 if (!isAuthenticated) { return NextResponse.redirect(new URL('/login', req.url)); } } export const config = { matcher: ['/dashboard/:path*'], // 将中间件应用于这些路由 };
关键点:
- 在请求完成前执行。
- 理想的身份验证、权限和访问控制方案。
- 允许灵活的、基于条件的重定向。
选择合适的重定向方法
每种方法都有不同的用途,选择哪种方法取决于您是否需要客户端导航、服务器端执行或 SEO 优化。
Next.js 页面重定向:总结
Next.js 提供灵活的重定向策略,适用于各种场景。无论您需要客户端、服务器端还是全局重定向,这些方法都能确保流畅的导航和更好的用户体验。
更多详情,请参考官方 Next.js 文档。
方法 | 用例 |
---|---|
redirect() 函数 | 服务器端强制重定向 |
next.config.js 重定向 | SEO 友好型,全局重定向 |
useRouter().push() | 客户端导航 |
中间件 | 基于条件的访问控制 |
立即在您的 Next.js 应用中实现高效的页面重定向!