React Router v6 路由配置详解:修复空白页与语法兼容性问题

大明姑娘_4832

大明姑娘_4832

2026-07-05

445人浏览

原创

React Router v6 路由配置详解:修复空白页与语法兼容性问题

本文详解 React Router v6 的核心变更,包括 Routes 组件的必要性、element 替代 component 的写法、以及如何正确嵌套路由结构,帮助你快速修复因版本不匹配导致的页面空白和运行错误。

本文详解 react router v6 的核心变更,包括 `routes` 组件的必要性、`element` 替代 `component` 的写法、以及如何正确嵌套路由结构,帮助你快速修复因版本不匹配导致的页面空白和运行错误。

React Router v6 与 v5 在 API 设计上存在重大不兼容变更,这是你项目中页面变为空白的根本原因。你当前使用的是 react-router-dom@6.16.0(v6),但代码仍沿用 v5 的 和独立 写法——这在 v6 中完全无效,且不会报明确错误,而是静默失败,最终导致渲染内容丢失。

✅ 正确的 v6 路由结构:三要素缺一不可

  1. 必须包裹在 中
    所有 必须作为 的直接子元素,就像 v5 中的 ;单独使用 不会被识别。

  2. 使用 element 替代 component / render / children
    element 接收已实例化的 JSX 元素(即带括号的 ),而非组件引用(Component)。它支持内联 props 传递(需注意闭包与重渲染风险)。

  3. 移除 exact 属性
    v6 默认采用精确匹配(exact match),路径 / 只匹配根路径,/about 不会误匹配 /about-us,无需 exact。

以下是修正后的 App.js:

react-pro
react-pro

你是一位 React 专家,擅长高级 Hook、性能优化、状态管理和现代 React 模式。适用场景:高级 Hook 模式...

下载
import React from 'react';
import Nav from './Nav';
import './App.css';
import Header from './Header';
import BookingPage from './bookingPage';
import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';

function App() {
  return (
    <router><nav></nav><header></header><routes>
        {/* ✅ 正确写法:element 接收 JSX,路径自动精确匹配 */}
        <route path="/" element="{<BookingPage"></route>} />
        {/* ? 建议补充其他路由,避免 404 */}
        <route path="/home" element="{<BookingPage"></route>} />
        <route path="/about" element="{<div">About Page} />
        <route path="*" element="{<div">404 — 页面未找到} />
      </route></route></routes></router>
  );
}

export default App;

⚠️ 关键注意事项

  • 不要在 element 中直接传参(如 element={})
    这会导致每次渲染都创建新元素,触发不必要的重渲染。如需传参,推荐使用 useNavigate + state 或 Context;或封装为函数组件再嵌套:

    <route path="/booking" element="{<BookingPageWrapper"></route>} />
    // 然后在 BookingPageWrapper 中返回 <bookingpage someprop="{...}"></bookingpage>

  • 当前 Nav 使用 to="/bookingPage",但你的路由是 path="/". 若希望点击“Reservations”跳转到预约页,请统一路径:

    {/* 在 Nav.js 中修改 Link */}
    
  • Reservations
  • 或新增对应路由:

<route path="/bookingPage" element="{<BookingPage"></route>} />
  • 关于 Node.js 报错 ERR_OSSL_EVP_UNSUPPORTED
    此错误与 React Router 无关,而是因 Node.js 17+ 默认禁用旧版 OpenSSL 加密算法所致(常见于 react-scripts@3.x)。解决方案(任选其一):

    • ✅ 升级 react-scripts 至 ^5.0.0(推荐):
      npm install react-scripts@latest
    • ⚠️ 临时降级 Node.js 至 16.x(LTS 版本)
    • ? 或设置环境变量(仅开发环境):
      # Windows PowerShell
      $env:NODE_OPTIONS = "--openssl-legacy-provider"
      npm start
  • ? 总结

    v5 写法(已废弃) v6 正确写法 说明
    } /> exact 移除,component → element
    } /> } /> v6 中 useParams/useNavigate 替代 render 函数
    独立使用 必须嵌套在 内 否则路由不生效

    完成上述调整后,重启开发服务器(npm start),你的预约页面将正常渲染,导航链接也可正确跳转。牢记:v6 的哲学是“声明式路由 + JSX 优先”,拥抱这一范式,可大幅提升路由逻辑的可读性与可维护性。

    相关文章

    路由优化大师
    路由优化大师

    路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

    下载

    相关标签:

    react 路由

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    2023.06.20

    5046

    5

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    2023.07.04

    1249

    3

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    2023.07.04

    4964

    6

    js删除节点的方法
    js删除节点的方法

    js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

    2023.09.01

    960

    4

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    2023.09.04

    1896

    5

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    2023.09.04

    3545

    4

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    2023.09.12

    4613

    6

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    2023.09.20

    3020

    5

    java访问控制修饰符介绍
    java访问控制修饰符介绍

    java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

    2023.09.20

    968

    7

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    React 教程
    React 教程

    共58课时 | 12.2万人学习

    国外Web开发全栈课程全集
    国外Web开发全栈课程全集

    共12课时 | 1.4万人学习