notFound

notFound 函数允许你在路由段内渲染 not-found 文件，并注入 <meta name="robots" content="noindex" /> 标签。

notFound()

调用 notFound() 函数会抛出 NEXT_HTTP_ERROR_FALLBACK;404 错误并终止抛出它的路由段的渲染。指定 not-found 文件 允许你通过在段内渲染 Not Found UI 来优雅地处理此类错误。

app/user/[id]/page.js

import { notFound } from 'next/navigation'

async function fetchUser(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 user = await fetchUser(id)

  if (!user) {
    notFound()
  }

  // ...
}

提示：由于使用 TypeScript never 类型，notFound() 不需要你使用 return notFound()。

版本历史

版本	更改
v13.0.0	引入了 notFound。