改版后旧路由仍指向旧实现

更新于 2026-07-03

**改版后用户点进某个入口却看到旧界面，第一嫌疑不是「新组件写错了」，而是「那条 route 还 import 着旧组件」。** 新版布局只在列表页生效、入口路由没一起切过去，旧 route 就会绕开新布局，直接渲染旧页面。

一、典型症状

  • 新版列表/面板已经做好了，但点标题、点列表项、或直接开某个 URL 后，看到的还是老式编辑页。
  • 新布局组件（如 ListColumn + ReaderSurface）明明存在，却只在部分路径出现。
  • 表现像「功能缺失 / 没生效」，实际是两条渲染路径并存，用户走的是旧那条。

二、根因与排查

根因示例：notes/[slug]/page.tsx 仍引用旧的 NoteEditorPage，该页面完全绕过了原型的新布局，于是点击标题/列表后进入了旧编辑页。

排查顺序：

  1. 找到用户实际进入的那条 route 文件；
  2. 看它 import / 渲染的是哪个组件（而不是看新组件写没写）；
  3. 对比新布局是否被该 route 引用——没被引用，就是没接上。

三、可迁移的判断

  • 改版要按「入口清单」收口，不是按「新组件写完」收口。 同一个功能往往有多个入口（点标题、点列表项、直接访问 URL、旧书签），要逐个确认都指向新实现。
  • 「新组件存在」≠「用户会用到它」。 判断界面行为要看入口路由指向谁，而不是仓库里有没有新代码。
  • 旧 route 保留 = 一条隐形的旧路径，会让新版看起来「时好时坏」。

相关