Menu

notFound

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

notFound()

调用 notFound() 函数会抛出一个 NEXT_NOT_FOUND 错误，并终止抛出该错误的路由段的渲染。通过指定一个 not-found 文件，你可以优雅地处理这类错误，在该段内渲染一个"未找到"界面。

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 user = await fetchUser(params.id);
 
  if (!user) {
    notFound();
  }
 
  // ...
}

值得注意的是：由于使用了 TypeScript 的 never 类型，notFound() 不需要你使用 return notFound()。

版本历史

版本变更
v13.0.0引入 notFound。