React Router v6.4+ 路由嵌套与布局组件正确用法详解_技术教程

当前问题源于在 navbar 中嵌套了独立的 `browserrouter`，导致其与主路由系统隔离；修复方式是移除冗余路由器，改用 `createbrowserrouter` + 布局组件 + `outlet` 实现统一导航与无刷新渲染。

在使用 react-router-dom v6.4+（推荐版本）时，必须确保所有和路由匹配逻辑运行在同一个路由器上下文内。你原始代码中存在两个相互独立的路由器实例：

App 中使用 createBrowserRouter + RouterProvider 管理 / 和 /history 页面；
NavBar 内部又包裹了一个 BrowserRouter，它创建了全新的、隔离的路由上下文——因此点击仅更新该子路由器的 URL，却无法触达主路由器的渲染逻辑，导致页面不切换，只能靠手动刷新“硬加载”。

✅ 正确做法：使用布局路由（Layout Route）统一管理导航与内容区域

首先，彻底移除 NavBar 中的 BrowserRouter 及其内部的 Route/Routes（v6.4+ 已弃用 Route/Routes 在非 RouterProvider 下使用）。NavBar 应仅为纯展示组件，不承载路由能力：

// src/components/NavBar.tsx
import { Link } from "react-router-dom";

function NavBar() {
  return (
    
      HOME
      
        History
      
    
  );
}

export default NavBar;

接着，在 App.tsx 中定义一个布局组件（如 AppLayout），将 NavBar 与动态内容区（）组合，并通过 children 配置嵌套路由：

// src/App.tsx
import {
  createBrowserRouter,
  RouterProvider,
  Outlet
} from "react-router-dom";
import NavBar from "./components/NavBar";
import HistoryPage from "./pages/HistoryPage";
import MainPage from "./pages/MainPage";

// 布局组件：复用导航栏 + 渲染子路由内容
const AppLayout = () => (
  <>
    
    
       {/* 子路由元素将在此处渲染 */}
    
  
);

// 主路由配置：根路径为布局组件，子路径对应具体页面
const router = createBrowserRouter([
  {
    element: ,
    children: [
      { path: "/", element:  },
      { path: "/history", element:  }
      // 可继续添加其他子路由，如 { path: "/about", element:  }
    ]
  }
]);

function App() {
  return ;
}

export default App;

⚠️ 关键注意事项

禁止嵌套多个 RouterProvider：BrowserRouter、HashRouter 或 RouterProvider 在应用中应全局唯一，否则路由状态无法同步。
Outlet 是占位符：它不是组件而是 React Router 提供的“插槽”，必须出现在布局组件中，用于渲染匹配到的子路由元素。
状态持久化自然达成：由于导航不再触发页面刷新，MainPage 中的 useRandomObject() 等自定义 Hook 将维持原有状态（如 randomObject 不会重复获取），完全符合你“避免重复拉取数据库随机项”的需求。
样式建议：为
添加 min-height: 100vh 等样式可避免 NavBar 与内容重叠，提升布局稳定性。