
本文详解 React Router v6 中 PrivateRoute 和 PublicRoute 自定义守卫的常见错误——误用 component 属性而非 children,并提供可直接复用的修复方案、使用示例及关键注意事项。
本文详解 react router v6 中 `privateroute` 和 `publicroute` 自定义守卫的常见错误——误用 `component` 属性而非 `children`,并提供可直接复用的修复方案、使用示例及关键注意事项。
在 React Router v6 中,
✅ 正确做法是:统一使用 children prop 接收并透传子元素。以下是修复后的完整守卫实现:
// src/components/RouteGuards.jsx
import React, { useContext } from "react";
import { AuthContext } from "../context/auth";
import { Navigate, useLocation } from "react-router-dom";
export const PrivateRoute = ({ children }) => {
const { user } = useContext(AuthContext);
const location = useLocation();
if (!user) {
return <navigate to="/login" state="{{" from: location replace></navigate>;
}
return children; // ✅ 直接渲染传入的 JSX 子节点
};
export const PublicRoute = ({ children }) => {
const { user } = useContext(AuthContext);
if (user) {
return <navigate to="/dashboard" replace></navigate>;
}
return children; // ✅ 未登录用户才渲染子内容(如 Login/Register)
};
? 使用方式(注意:无需 element={...} 包裹,直接嵌套):
<routes><route path="/" element="{<Home"></route>} />
<route path="/about" element="{<About"></route>} />
{/* ✅ 正确:children 模式 */}
<route path="/register" element="{"><register></register>
} />
<route path="/login" element="{"><login></login>
} />
<route path="/dashboard" element="{"><dashboard></dashboard>
} />
</route></route></route></routes>
⚠️ 关键注意事项:
- replace: true 推荐添加在
中,避免登录/登出后点击浏览器“返回”按钮跳回受保护页面; - AuthContext 必须确保在 Router 上层 Provider 中正确包裹,否则 useContext 将返回 undefined;
- 不要对 children 做额外条件判断(如 children && children),因为 children 可能是 null、string 或 Fragment,直接 return children 即可;
- 若需支持多个子元素(如带布局的页面),可配合 React.Fragment 或自定义 Layout 组件,children 天然支持任意合法 JSX。
通过以上修正,路由守卫将严格按身份状态分流:未登录用户可自由访问 /login 和 /register;已登录用户访问二者时被重定向至 /dashboard;而 /dashboard 等私有路径仅对已认证用户开放——逻辑闭环,体验健壮。











