React / 系统课时

处理不存在页面

处理不存在页面

本课建立 App Router 的 404 处理方式:未匹配地址使用全局不存在页面,资源查询为空时主动调用 notFound()。完成后,用户不会再看到含糊的空白详情页。

学习目标

  • 创建路由分支的 not-found.tsx
  • 在资源不存在时调用 notFound()
  • 区分不存在资源与系统运行异常

两类不存在场景

第一类是地址没有任何页面可以匹配,例如访问 /unknown-path;第二类是路由能够匹配,但对应资源不存在,例如 /products/999。前者通常由根级 404 界面处理,后者应由页面查询结果主动触发。

不要返回状态为“成功”的空详情页,也不要把资源不存在抛成普通系统异常。404 是明确的导航结果,应该提供返回列表或搜索其他内容的入口。

创建资源级 404 页面

下面是片段示例,需要分别保存到对应文件。详情页根据动态编号查询商品,查询不到时调用 notFound(),框架随后渲染最近一层的 not-found.tsx。

tsx
// app/products/[id]/page.tsx
import { notFound } from 'next/navigation'

const products: Record<string, { name: string; price: number }> = {
  '1': { name: '机械键盘', price: 399 },
  '2': { name: '无线鼠标', price: 199 },
}

export default async function ProductPage({
  params,
}: {
  params: Promise<{ id: string }>
}) {
  const { id } = await params
  const product = products[id]

  if (!product) {
    notFound()
  }

  return (
    <main>
      <h1>{product.name}</h1>
      <p>价格:¥{product.price}</p>
    </main>
  )
}

// app/products/[id]/not-found.tsx
import Link from 'next/link'

export default function ProductNotFound() {
  return (
    <main>
      <h1>商品不存在</h1>
      <p>该商品可能已下架,或链接中的编号不正确。</p>
      <Link href="/products">返回商品列表</Link>
    </main>
  )
}

预期结果:已有编号显示商品详情,不存在的编号显示自定义 404 内容,并提供返回列表的链接。

text
/products/1   -> 机械键盘,价格 ¥399
/products/999 -> 商品不存在

设计可用的不存在页面

404 页面应说明用户当前遇到的是“内容不存在”,而不是笼统显示“系统错误”。对于商品、文章和订单,可根据场景提供返回列表、重新搜索或检查链接等下一步操作。

notFound() 会立即终止当前页面的正常渲染,因此不要在它之后继续编写依赖资源存在的分支。数据访问层返回 null 后,在页面边界统一决定是否进入 404,可以让组件保持更清晰。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理不存在页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通