permanentRedirect

permanentRedirect 函数允许您将用户重定向到另一个 URL。permanentRedirect 可用于服务器组件、客户端组件、路由处理程序和服务器操作。

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

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

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

参数

permanentRedirect 函数接受两个参数

permanentRedirect(path, type)

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

在服务器组件中使用时，type 参数无效。

返回

permanentRedirect 不返回任何值。

示例

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

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 类型。