跳到主要内容

permanentRedirect

permanentRedirect 函数允许你将用户重定向到另一个 URL。permanentRedirect 可以在服务端组件、客户端组件、路由处理器 和 服务器操作 中使用。

在流式上下文中使用时，这将插入一个 meta 标签以在客户端发出重定向。在服务器操作中使用时，它将向调用者提供 303 HTTP 重定向响应。否则，它将向调用者提供 308（永久）HTTP 重定向响应。

如果资源不存在，你可以使用 notFound 函数 代替。

提示：如果你更喜欢返回 307（临时）HTTP 重定向而不是 308（永久），你可以使用 redirect 函数 代替。

参数​

permanentRedirect 函数接受两个参数：

permanentRedirect(path, type)
参数类型描述
pathstring要重定向到的 URL。可以是相对或绝对路径。
type'replace'（默认）或 'push'（在服务器操作中默认）要执行的重定向类型。

默认情况下，permanentRedirect 在 服务器操作 中使用 push（在浏览器历史堆栈中添加新条目），在其他地方使用 replace（替换浏览器历史堆栈中的当前 URL）。你可以通过指定 type 参数来覆盖此行为。

type 参数在服务端组件中使用时没有效果。

返回值​

permanentRedirect 不返回值。

示例​

调用 permanentRedirect() 函数会抛出 NEXT_REDIRECT 错误并终止抛出它的路由段的渲染。

app/team/[id]/page.js
import { permanentRedirect } from 'next/navigation'

async function fetchTeam(id) {
  const res = await fetch('https://...')
  if (!res.ok) return undefined
  return res.json()
}

export default async function Profile({ params }) {
  const { id } = await params
  const team = await fetchTeam(id)
  if (!team) {
    permanentRedirect('/login')
  }

  // ...
}

提示：permanentRedirect 不需要你使用 return permanentRedirect()，因为它使用 TypeScript never 类型。

最后于 更新