React Router v6+ 中 Route 必须被 Routes 组件包裹才能正确匹配和渲染，直接将 Route 作为子元素会导致页面空白——这是版本升级后最常见且易忽略的结构变更。
react router v6+ 中 `route` 必须被 `routes` 组件包裹才能正确匹配和渲染，直接将 `route` 作为子元素会导致页面空白——这是版本升级后最常见且易忽略的结构变更。
在 React Router v6.17（及所有 v6.x 版本）中，路由配置方式发生了根本性变化：Route 不再是独立可渲染的组件，而必须作为 Routes 的直接子元素。Routes 是一个内置的“路由匹配器”，它会遍历其子 Route 并根据当前 URL 渲染第一个匹配的 element。若省略 Routes，所有 Route 将被当作普通 JSX 元素忽略，导致页面内容完全不渲染——这正是你遇到“加载空白”的根本原因。
✅ 正确写法如下（关键修改已加注）：
Ainative React Sdk
下载
使用 @ainative/react-sdk 为 React 应用添加 AI 聊天和积分。适用于 (1) 安装 @ainative/react-sdk，(2) 使用 useChat hook 实现聊天完成。
import React from 'react';
import {
BrowserRouter as Router,
Routes, // ✅ 必须显式导入 Routes
Route
} from 'react-router-dom';
import { Container } from 'react-bootstrap';
import Header from './components/Header';
import Footer from './components/Footer';
import HomeScreen from './screens/HomeScreen';
import ProductScreen from './screens/ProductScreen';
const App = () => {
return (
<router><header></header><main classname="py-3"> {/* ⚠️ 注意：此处为 className，非 clasName（拼写错误也需修复） */}
<container><routes> {/* ✅ Routes 是必需的容器组件 */}
<route path="/" element="{<HomeScreen"></route>} />
<route path="/product/:id" element="{<ProductScreen"></route>} />
</routes></container></main><footer></footer></router>
);
};
export default App;
? 关键要点总结：
- Routes 不可省略：它是 v6 的核心路由协调器，替代了 v5 中 Switch 的作用；
- exact 属性已废弃：v6 默认采用精确匹配逻辑（path="/"仅匹配根路径），无需 exact；
-
element 接收 JSX 元素（非组件）：必须传入
形式，不能传 Component 或 render 函数； - 拼写校验：className 写成 clasName 会导致样式失效（虽不影响路由，但可能加剧调试困惑）；
- 嵌套路由扩展性：如需子路由（如 /product/123/reviews），可在 ProductScreen 内部再次使用 Routes + Route 实现嵌套。
完成上述修改后，重启应用即可正常显示 HomeScreen 和 ProductScreen。建议同步检查浏览器控制台是否有 React Router 相关警告（如 No routes matched location "/"），这通常是 Routes 缺失的明确提示。
