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,可以让组件保持更清晰。
按自己的节奏,确认真正理解。