Nuxt 3 博客改版后旧链接 404 的补救:301 映射、监控和 canonical 闭环
一次博客路由改版让旧链接大量 404,搜索流量明显下滑。本文记录我如何用 301 映射表接住旧入口,用 404 监控补漏,再用 canonical 和 sitemap 帮助收录恢复。

作者
ZHOUYI
上次把博客从 /post/:slug 改成 /blog/:slug 后,Search Console 的点击掉得很快。起初以为是内容不受欢迎,后来翻日志才发现,大量旧链接直接 404。对搜索引擎来说,这不是小改版,而是整批页面突然消失。我赶紧把目标从“页面能打开”改成“旧入口有归宿”。
301 映射表:先把旧路接回去
我没有逐个写死规则,而是建了一张旧路径到新路径的映射表:文章类按 slug 迁移,栏目类按前缀合并,已删除内容单独标记。线上优先查 Redis,未命中再查 MongoDB,避免每次 404 都打数据库。命中后统一返回 301,不把旧页当新页渲染。
export default defineNuxtConfig({
routeRules: {
'/post/old-slug': {
redirect: { to: '/blog/old-slug', statusCode: 301 }
}
}
})404 监控:把漏网路径捞出来
- 记录未命中的 path、referer、user-agent 和状态码
- 按天聚合,优先处理来自搜索引擎和高频访问的旧链
- 对连续增长的 404 路径设阈值,避免流量悄悄漏掉
- 确认修复后回写映射表,并复查是否变成重定向循环
canonical 与 sitemap:让收录跟上新结构
重定向只解决访问,还要告诉搜索引擎新地址是正式版。我在文章页 head 里补 canonical,指向当前新 URL;sitemap 只保留可访问的新链接,不把旧链接混进去。对于彻底删除的内容,返回 404 或 410,不乱跳首页,避免产生软 404。
“改版最怕的不是代码报错,而是旧入口悄悄失效。301 保住访问,监控发现遗漏,canonical 和 sitemap 帮助收录,三者闭环才安心。”
一周后,404 数量明显下降,搜索点击也逐步恢复。我的经验是:改版前先导出旧路由,上线当天就看重定向和日志,别等流量跌了再补。