本文旨在帮助开发者解决在使用 Next.js 13.4 及更高版本创建多页面应用时遇到的 404 错误。通过深入理解 Next.js 的文件路由约定，并结合清晰的代码示例，本文将指导你正确组织项目结构，确保每个页面都能被成功访问，从而避免 404 错误的发生。
在 Next.js 13.4 及更高版本中，App Router 引入了基于文件系统的路由机制，极大地简化了页面路由的配置。然而，如果对这种新的路由方式理解不够深入，很容易在创建多页面应用时遇到 404 错误。 这个错误通常是由于文件结构不符合 Next.js 的约定导致的。
理解 Next.js App Router 的文件路由约定
App Router 的核心思想是：目录结构决定了路由路径，而 page.js 或 page.ts 文件则负责渲染特定路由的内容。 换句话说，Next.js 会根据 app 目录下文件夹的层级结构自动生成路由。
- 根路由: app/page.js 对应于根路由 http://localhost:3000/
- 子路由: 在 app 目录下创建文件夹，并在文件夹内放置 page.js 或 page.ts 文件，即可创建子路由。例如，app/foo/page.js 对应于 http://localhost:3000/foo。
- 嵌套路由: 文件夹可以嵌套，以创建更深层次的路由。例如，app/foo/bar/page.js 对应于 http://localhost:3000/foo/bar。
正确的文件结构示例
为了避免 404 错误，请确保你的文件结构遵循以下模式：
app/
page.js // -> http://localhost:3000/
foo/
page.js // -> http://localhost:3000/foo
bar/
page.js // -> http://localhost:3000/foo/bar
contact/
page.js // -> http://localhost:3000/contact代码示例
假设我们要创建一个名为 about 的页面。首先，在 app 目录下创建一个名为 about 的文件夹。 然后，在该文件夹中创建一个名为 page.js 的文件，并添加以下代码：
// app/about/page.js
export default function AboutPage() {
return (
About Us
This is the about page.
);
}现在，访问 http://localhost:3000/about 应该就能看到 "About Us" 页面了。
常见问题及解决方法
- 缺少 page.js 或 page.ts 文件: 确保每个路由对应的文件夹中都包含 page.js 或 page.ts 文件。
- 文件命名错误: 必须使用 page.js 或 page.ts 作为页面组件的文件名。
- 文件夹结构错误: 仔细检查文件夹结构是否符合你期望的路由路径。
总结
在 Next.js 13.4 及更高版本中，App Router 提供了一种简洁而强大的路由管理方式。 通过理解和遵循其文件路由约定，你可以轻松地创建多页面应用，并避免常见的 404 错误。 记住，文件夹结构定义了路由路径，而 page.js 或 page.ts 文件则负责渲染页面内容。 希望本文能帮助你更好地理解 Next.js 的路由机制，并在你的项目中顺利应用。
