本文详解如何在 Next.js 中通过 next.config.js 的 redirects 配置，实现对所有未定义路由的服务器端永久（301）重定向到 /home，避免 404 页面，提升 SEO 友好性与用户体验。
本文详解如何在 next.js 中通过 `next.config.js` 的 `redirects` 配置，实现对所有未定义路由的服务器端永久（301）重定向到 `/home`，避免 404 页面，提升 seo 友好性与用户体验。
在 Next.js 应用中，当用户访问如 /nonexistent 或 /old-page 等未定义路由时，框架默认返回 HTTP 404 状态并渲染 app/not-found.tsx（App Router）或 pages/404.tsx（Pages Router）。但正如实际业务场景所述——你已迁移域名、旧 URL 大量失效——此时返回 404 不仅损害用户体验，更会稀释搜索引擎权重。真正的解决方案不是客户端跳转（如 useEffect + router.push），而是服务端发起的 HTTP 301 永久重定向，确保状态码正确、SEO 友好、且无闪烁或白屏。
✅ 正确做法：使用 next.config.js 中的 redirects 配置（支持 App Router 和 Pages Router）
以下为适用于 Next.js 13.4+（App Router） 的完整配置示例：
// next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
async redirects() {
return [
{
source: '/:path*',
destination: '/home',
permanent: true, // → 发送 301 状态码
has: [
{
type: 'header',
key: 'x-nextjs-data', // 排除数据请求（如 getServerSideProps 的 /_next/data 请求）
value: undefined,
},
],
},
];
},
};
module.exports = nextConfig;⚠️ 关键说明：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- source: '/:path*' 使用通配符匹配所有路径（包括 /, /abc, /x/y/z），但不匹配静态资源（如 /favicon.ico, /_next/...）——Next.js 内部已自动排除。
- permanent: true 是核心：它等价于 statusCode: 301，明确告知浏览器和搜索引擎该重定向是永久性的，利于链接权重传递。
- has 条件用于排除数据请求（如客户端触发的 fetch('/api/...') 或 Next.js 自动发起的 RSC 数据请求），避免将 API 请求错误重定向导致功能异常。若未使用 getServerSideProps 或 fetch 数据请求，此条件可省略。
? 补充建议（提升健壮性）：
- 若你仍需保留部分 404 场景（如明确废弃的敏感路径），可在 redirects 数组中前置更具体的规则，利用“匹配优先”原则：
{ source: '/admin/:path*', destination: '/403', permanent: false, // 307 临时重定向 }, { source: '/:path*', destination: '/home', permanent: true, } - 确保 /home 路由真实存在且可被服务端访问（例如 app/home/page.tsx），否则将触发循环重定向或 500 错误。
❌ 不推荐的方案：
- 客户端跳转（如 useEffect + router.push）：返回 404 状态码，无法传递 SEO 权重，存在 FOUC（闪屏）、JS 禁用时失效、LCP 指标恶化等问题；
- 自定义 404.tsx 中强制跳转：仍是 404 响应，违背语义，且无法拦截爬虫或直接请求。
最后，请务必在部署前通过 curl -I https://yoursite.com/unknown-path 验证响应头是否含 Location: /home 和 301 Moved Permanently。一次正确的 301 重定向，既是技术严谨性的体现，也是对用户与搜索引擎的双重尊重。
