React / 系统课时
处理动态路由
处理动态路由
本课解决“同一类资源有多个编号,却不想为每个编号创建页面文件”的问题。你将用动态段接收路径参数,并在资源不存在时主动进入 404 处理流程。
学习目标
- 使用
[参数名]目录声明动态路由 - 在页面组件中安全读取异步
params - 对无效编号调用
notFound()终止正常渲染
动态段的目录规则
把目录名写成 [id],该位置就会匹配一个路径片段。例如 app/articles/[id]/page.tsx 可以同时处理 /articles/101 与 /articles/202,其中 id 分别为字符串 "101" 和 "202"。
一个动态段只匹配一层路径。需要匹配多层剩余路径时可使用 [...slug],允许缺省时则使用 [[...slug]]。基础资源详情页通常只需要 [id],先选择最简单的目录形式。
读取并校验路径参数
当前 App Router 页面中的 params 是 Promise,因此页面组件应声明为 async 并先执行 await params。下面的完整页面使用内存数据模拟文章查询,同时校验编号和资源是否存在。
tsx
// app/articles/[id]/page.tsx
import { notFound } from 'next/navigation'
type PageProps = {
params: Promise<{ id: string }>
}
const articles: Record<string, { title: string; content: string }> = {
'101': { title: '认识 App Router', content: '路由由 app 目录结构定义。' },
'202': { title: '理解布局', content: 'layout.tsx 用于复用公共界面。' },
}
export default async function ArticlePage({ params }: PageProps) {
const { id } = await params
// 路径参数来自 URL,先验证格式再参与查询。
if (!/^\d+$/.test(id)) {
notFound()
}
const article = articles[id]
if (!article) {
notFound()
}
return (
<article>
<p>文章编号:{id}</p>
<h1>{article.title}</h1>
<p>{article.content}</p>
</article>
)
}预期结果:访问已有编号会显示对应文章,访问格式错误或不存在的编号会进入当前路由分支的 not-found.tsx,若未提供则使用上层 404 界面。
text
/articles/101 -> 显示“认识 App Router”
/articles/999 -> 显示 404 界面
/articles/abc -> 显示 404 界面路径参数的边界
路径参数始终来自外部输入,不应直接拼接到 SQL、文件路径或权限条件中。先验证格式,再调用数据访问层,并把“编号合法但资源不存在”与“系统异常”分开处理:前者进入 404,后者交给错误边界。
动态路由适合标识具体资源,如文章、商品和用户。筛选条件、排序方式与页码通常是可选状态,更适合放在查询字符串中,而不是继续增加路径层级。
按自己的节奏,确认真正理解。