
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 应用中实现高效的页面重定向!










