在React Router中使用JWT的實現(xiàn)

更新時間：2026年06月01日 14:38:40 作者：1991張先生

本文主要介紹了在React Router中使用JWT的實現(xiàn),包括創(chuàng)建AuthProvider和AuthContext,實現(xiàn)ProtectedRoute組件,以及在React項目中處理公共路由和受校驗保護(hù)路由,下面就來詳細(xì)的介紹一下

創(chuàng)建一個 React 項目

使用下方的指令會為我們創(chuàng)建一個項目

$ npm create vite@latest react-jwt-cn

然后我們選擇 react 和 javascript 作為我們的框架和語言。在項目開始之前，我們要確保所有的依賴都已經(jīng)被安裝，所以我們要先執(zhí)行

$ npm install

安裝完畢后，在項目的根目錄下，我們可以運(yùn)行下面的指令來啟動我們的項目

$ npm run dev

我們通過這些步驟來讓我們的 React 項目順利啟動和運(yùn)行

安裝React-Router 和 Axios

在我們繼續(xù)之前，要確保我們已經(jīng)為我們的項目安裝了必要的依賴項。我們將從安裝 react-router v6 開始，它將處理我們的 React 應(yīng)用程序中的路由。此外，我們將安裝 Axios，這是一個用于發(fā)送 API 請求的庫。通過執(zhí)行這些步驟，我們將配備實現(xiàn)無縫路由和執(zhí)行高效 API 通信所需的工具。讓我們從安裝這些依賴項開始。

$ npm install react-router-dom axios

在 React 中創(chuàng)建AuthProvider 和 AuthContext

接下來我們要實現(xiàn)的就是 JWT 身份驗證的功能。在這個小節(jié)中我們將創(chuàng)建一個 AuthProvider 組件和一個關(guān)聯(lián)的 AuthContext 。這將協(xié)助我們在整個應(yīng)用中存儲和共享 JWT 身份驗證相關(guān)的數(shù)據(jù)和函數(shù)

在 src > provider 下創(chuàng)建 authProvider.js 。然后我們來探 AuthProvider 和 AuthContext 的實現(xiàn)

導(dǎo)入必要的模塊和依賴包：
1. 導(dǎo)入 axios 用于發(fā)送 API 請求
2. 從 react 導(dǎo)入 createContext useContext useEffect useMemo 以及 useState

import axios from "axios";
import {
  createContext,
  useContext,
  useEffect,
  useMemo,
  useState,
} from "react";

使用 createContext() 來創(chuàng)建一個用于身份驗證的上下文
1. createContext() 創(chuàng)建的空的上下文是用于在組件之間共享身份驗證的數(shù)據(jù)和函數(shù)的

const AuthContext = createContext();

創(chuàng)建 AuthProvider 組件
1. 這個組件是用于作為身份驗證上下文的 provider
2. 它接收 children 作為 prop，代表將有權(quán)訪問身份驗證上下文的子組件。

const AuthProvider = ({ children }) => {
  // 組件內(nèi)容寫在這里
};

使用 useState 定義一個名為 token 的 state
1. token 代表的是身份驗證的令牌
2. 如果令牌數(shù)據(jù)存在的話，我們將通過 localStorage.getItem("token") 來獲取它

const [token, setToken_] = useState(localStorage.getItem("token"));

創(chuàng)建 setToken 函數(shù)來更新身份驗證的令牌數(shù)據(jù)
1. 這個函數(shù)將會用于更新身份驗證的令牌
2. 它使用 setToken_ 函數(shù)更新令牌數(shù)據(jù)并且將更新之后的數(shù)據(jù)通過 localStorage.setItem() 存儲在本地環(huán)境

const setToken = (newToken) => {
  setToken_(newToken);
};

使用 useEffect() 來設(shè)置 axios 默認(rèn)的身份驗證請求頭并且將身份驗證的令牌數(shù)據(jù)保存到本地
1. 每當(dāng) token 更新，這個 effect 函數(shù)都會執(zhí)行
2. 如果 token 存在，它將被設(shè)置為 axios 的請求頭并且保存到本地 localStorage 中
3. 如果 token 是 null 或者 undefined ，它將移除對應(yīng)的 axios 請求頭以及本地身份驗證相關(guān)的 localStorage 的數(shù)據(jù)

useEffect(() => {
  if (token) {
    axios.defaults.headers.common["Authorization"] = "Bearer " + token;
    localStorage.setItem('token',token);
  } else {
    delete axios.defaults.headers.common["Authorization"];
    localStorage.removeItem('token')
  }
}, [token]);

使用 useMemo 創(chuàng)建記憶化的上下文
1. 這個上下文包含 token 和 setToken 函數(shù)
2. token 的值會被作為記憶化的依賴項（如果 token 不變，則不會重新渲染）

const contextValue = useMemo(
  () => ({
    token,
    setToken,
  }),
  [token]
);

給自組件注入身份驗證的上下文
1. 使用 AuthContext.Provider 包裹子組件
2. 把 contextValue 作為 provider 的值傳入

return (
  <AuthContext.Provider value={contextValue}>
    {children}
  </AuthContext.Provider>
);

導(dǎo)出 useAuth 這個 hook ，以供外部使用到身份驗證這個 context
1. useAuth 是一個自定義的 hook，它可以讓子組件很方便的訪問到身份驗證信息

export const useAuth = () => {
  return useContext(AuthContext);
};

默認(rèn)導(dǎo)出 AuthProvider

export default AuthProvider;

完整代碼

import axios from "axios";
import {
  createContext,
  useContext,
  useEffect,
  useMemo,
  useState,
} from "react";
const AuthContext = createContext();
const AuthProvider = ({ children }) => {
    const [token, setToken_] = useState(localStorage.getItem("token"));
    const setToken = (newToken) => {
        setToken_(newToken);
    };
    useEffect(() => {
        if (token) {
          axios.defaults.headers.common["Authorization"] = "Bearer " + token;
          localStorage.setItem('token',token);
        } else {
          delete axios.defaults.headers.common["Authorization"];
          localStorage.removeItem('token')
        }
    }, [token]);
    const contextValue = useMemo(
        () => ({
          token,
          setToken,
        }),
        [token]
    );
    return (
        <AuthContext.Provider value={contextValue}>
          {children}
        </AuthContext.Provider>
    );
};
export const useAuth = () => {
    return useContext(AuthContext);
};
export default AuthProvider;

小結(jié)，此代碼使用 React 的 context API 設(shè)置身份驗證上下文。它通過 context 向子組件提供身份驗證令牌和 setToken 函數(shù)。它還確保在身份驗證令牌更新時可以及時更新 axios 中的默認(rèn)授權(quán)請求頭。

為 JWT 身份驗證創(chuàng)建路由

為了能夠更高效的組織路由，我們將創(chuàng)建一個 src > routes 目錄。在這個目錄里，我們將創(chuàng)建一個 index.jsx 文件，這個文件用來作為定義整個應(yīng)用路由的入口。通過在單獨(dú)的文件夾中構(gòu)建我們的路由，我們可以保持清晰且易于管理的路由結(jié)構(gòu)。讓我們繼續(xù)創(chuàng)建路由并探索如何將 JWT 身份驗證集成到我們的 React 應(yīng)用程序中。

為身份驗證路由創(chuàng)建受保護(hù)路由組件

為了保護(hù)我們身份驗證的路由并防止未經(jīng)授權(quán)的訪問，我們將創(chuàng)建一個名為 ProtectedRoute 的組件。這個組件將包裹我們的身份驗證路由，以確保只有被授權(quán)的用戶才能夠訪問。通過現(xiàn)實這個組件，我們可以輕松完成身份驗證需求并提供良好的用戶體驗。我們將在 src > routes 下創(chuàng)建 ProtectedRoute.jsx 文件

首先我們要從 react-router-dom 中導(dǎo)入必要的依賴

import { Navigate, Outlet } from "react-router-dom";
import { useAuth } from "../provider/authProvider";

定義 ProtectedRoute 組件，讓它包裹我們所有的需要鑒權(quán)的路由

export const ProtectedRoute = () => {
    const { token } = useAuth();
  
    // 判斷用戶是否有權(quán)限
    if (!token) {
      // 如果沒有授權(quán)，則跳轉(zhuǎn)到登錄頁面
      return <Navigate to="/login" />;
    }
  
    // 如果已經(jīng)授權(quán)，則直接渲染子組件
    return <Outlet />;
 };

在 ProtectedRoute 組件中，我們通過 AuthContext 提供的自定義 hook （useAuth）來獲取 token 信息
接下來我們檢查 token 是否存在。如果用戶沒有被授權(quán)（ token 是 faslse 或者是 null ），我們將把路由導(dǎo)航到登錄頁面（/login ）
如果用戶被授權(quán)了，我們將使用 Outlet 組件來渲染子路由。Outlet 組件充當(dāng)占位符，顯示父路由中定義的子組件。

小結(jié)，ProtectedRoute 組件充當(dāng)了身份驗證的路由的守衛(wèi)。如果用戶未通過身份驗證，他們將被重定向到登錄頁面。如果用戶通過身份驗證，則 ProtectedRoute 組件中定義的子路由將使用 Outlet 組件呈現(xiàn)。

上述代碼使我們能夠根據(jù)用戶的身份驗證狀態(tài)輕松保護(hù)特定路由并控制訪問，從而在我們的 React 應(yīng)用程序中提供安全的導(dǎo)航體驗。

深入探索路由

現(xiàn)在我們已經(jīng)有了 ProtectedRoute 組件和身份驗證上下文，我們可以繼續(xù)定義我們的路由。通過區(qū)分公共路由、受校驗保護(hù)路由和非認(rèn)證用戶路由，我們可以有效地處理基于 JWT 認(rèn)證的導(dǎo)航和訪問控制。接下來我們將深入到 src > routes > index.jsx 文件并探索如何將 JWT 身份校驗集成到我們的路由結(jié)構(gòu)中

導(dǎo)入必要的依賴
1. RouterProvider 和 createBrowserRouter 用于配置和提供路由功能
2. useAuth 運(yùn)行我們訪問身份校驗的上下文
3. ProtectedRoute 組件包裹著受校驗路由

import { RouterProvider, createBrowserRouter } from "react-router-dom";
import { useAuth } from "../provider/authProvider";
import { ProtectedRoute } from "./ProtectedRoute";

定義路由組件
1. 該函數(shù)組件充當(dāng)配置應(yīng)用程序路由的入口

const Routes = () => {
  const { token } = useAuth();
  // 路由配置寫在這里
};

使用 useAuth hook 訪問身份校驗令牌
1. 調(diào)用 useAuth hook 可以從身份校驗上下文中獲取令牌

const { token } = useAuth();

定義面向所有用戶的路由（公共路由）
1. routesForPublic 數(shù)組保護(hù)所有可被所有用戶訪問的路由信息。每個路由信息對象包含一個 path 和一個 element
2. path 屬性明確了路由的 URL 路徑，element 屬性指向該路由下需要渲染的 jsx 組件/元素

const routesForPublic = [
  {
    path: "/service",
    element: <div>Service Page</div>,
  },
  {
    path: "/about-us",
    element: <div>About Us</div>,
  },
];

定義只有授權(quán)用戶可以訪問的路由
1. routesForAuthenticatedOnly 數(shù)組包含只能由經(jīng)過身份驗證的用戶訪問的路由對象。它包括包裝在 ProtectedRoute 組件中的受保護(hù)根路由（“/”）和使用 children 屬性定義的其他子路由。

const routesForAuthenticatedOnly = [
  {
    path: "/",
    element: <ProtectedRoute />,
    children: [
      {
        path: "/",
        element: <div>User Home Page</div>,
      },
      {
        path: "/profile",
        element: <div>User Profile</div>,
      },
      {
        path: "/logout",
        element: <div>Logout</div>,
      },
    ],
  },
];

定義只有沒有授權(quán)的用戶才可以訪問的路由
1. routesForNotAuthenticatedOnly 數(shù)組包含沒有經(jīng)過身份驗證的用戶訪問的路由對象。它包含登錄路由（/login ）

const routesForNotAuthenticatedOnly = [
  {
    path: "/",
    element: <div>Home Page</div>,
  },
  {
    path: "/login",
    element: <div>Login</div>,
  },
];

基于身份驗證狀態(tài)來組合和判斷路由
1. createBrowserRouter 函數(shù)用于創(chuàng)建路由配置，它接收一個路由數(shù)組作為入?yún)?/li>
2. 擴(kuò)展運(yùn)算符 (…) 用于將多個路由數(shù)組合并到一個數(shù)組
3. 條件表達(dá)式 (!token ? routesForNotAuthenticatedOnly : []) 檢查用戶是否已通過身份驗證（令牌存在）。如果不是，則包含 routesForNotAuthenticatedOnly 數(shù)組；否則，它包含一個空數(shù)組。

const router = createBrowserRouter([
  ...routesForPublic,
  ...(!token ? routesForNotAuthenticatedOnly : []),
  ...routesForAuthenticatedOnly,
]);

使用 RouterProvider 注入路由配置
1. RouterProvider 組件包裝路由配置，使其可用于整個應(yīng)用程序

return <RouterProvider router={router} />;

完整代碼

import { RouterProvider, createBrowserRouter } from "react-router-dom";
import { useAuth } from "../provider/authProvider";
import { ProtectedRoute } from "./ProtectedRoute";

const Routes = () => {
  const { token } = useAuth();

  // 公共路由配置
  const routesForPublic = [
    {
      path: "/service",
      element: <div>Service Page</div>,
    },
    {
      path: "/about-us",
      element: <div>About Us</div>,
    },
  ];

  // 授權(quán)的用戶才可以訪問的路由配置
  const routesForAuthenticatedOnly = [
    {
      path: "/",
      element: <ProtectedRoute />, // Wrap the component in ProtectedRoute
      children: [
        {
          path: "/",
          element: <div>User Home Page</div>,
        },
        {
          path: "/profile",
          element: <div>User Profile</div>,
        },
        {
          path: "/logout",
          element: <div>Logout</div>,
        },
      ],
    },
  ];

  // 沒有授權(quán)的用戶才可以訪問的路由配置
  const routesForNotAuthenticatedOnly = [
    {
      path: "/",
      element: <div>Home Page</div>,
    },
    {
      path: "/login",
      element: <div>Login</div>,
    },
  ];

  // 合并路由配置
  const router = createBrowserRouter([
    ...routesForPublic,
    ...(!token ? routesForNotAuthenticatedOnly : []),
    ...routesForAuthenticatedOnly,
  ]);

  return <RouterProvider router={router} />;
};

export default Routes;

最后整合

現(xiàn)在我們已經(jīng)準(zhǔn)備好了 AuthContext, AuthProvider 和 Routes 。讓我們把它們整合到 App.jsx

導(dǎo)入必要的組件和文件
1. AuthProvider 是從 ./provider/authProvider 文件中導(dǎo)入的組件。它為整個應(yīng)用程序提供了身份驗證的上下文
2. 從 ./routes 中導(dǎo)入 Routes 。它定義了應(yīng)用路由

import AuthProvider from "./provider/authProvider";
import Routes from "./routes";

使用 AuthProvider 組件包裝 Routes 組件
1. AuthProvider 組件用于向應(yīng)用程序提供身份驗證上下文。它包裝了 Routes 組件，使身份驗證上下文可用于 Routes 組件樹中的所有組件

return (
  <AuthProvider>
    <Routes />
  </AuthProvider>
);

完整代碼

import AuthProvider from "./provider/authProvider";
import Routes from "./routes";

function App() {
  return (
    <AuthProvider>
      <Routes />
    </AuthProvider>
  );
}

export default App;

實現(xiàn)登錄與登出

在 src > pages > Login.jsx 創(chuàng)建 登錄頁面

const Login = () => {
  const { setToken } = useAuth();
  const navigate = useNavigate();

  const handleLogin = () => {
    setToken("this is a test token");
    navigate("/", { replace: true });
  };

  setTimeout(() => {
    handleLogin();
  }, 3 * 1000);

  return <>Login Page</>;
};

export default Login;

登錄組件是一個用于表示登錄頁面的函數(shù)組件
使用 useAuth hook 從身份校驗上下文中導(dǎo)入 setToken 函數(shù)
從 react-router-dom 中導(dǎo)入 navigate 函數(shù)用于處理路由跳轉(zhuǎn)
在組件內(nèi)部，有一個 handleLogin 函數(shù)，它使用上下文中的 setToken 函數(shù)設(shè)置測試令牌，并導(dǎo)航到主頁 (“/”)，并將替換選項（replace）設(shè)置為 true
setTimeout 函數(shù)用于模擬執(zhí)行 handleLogin 函數(shù)前的 3 秒延遲
組件為登錄頁返回 JSX，在此處充當(dāng)一個占位符文本

現(xiàn)在，我們在 src > pages > Logout.jsx 創(chuàng)建一個 登出頁面

import { useNavigate } from "react-router-dom";
import { useAuth } from "../provider/authProvider";

const Logout = () => {
  const { setToken } = useAuth();
  const navigate = useNavigate();

  const handleLogout = () => {
    setToken();
    navigate("/", { replace: true });
  };

  setTimeout(() => {
    handleLogout();
  }, 3 * 1000);

  return <>Logout Page</>;
};

export default Logout;

在登出頁面中，我們調(diào)用了 setToken 函數(shù)并且沒有傳參，這相當(dāng)于調(diào)用 setToken(null)

現(xiàn)在，我們將用更新后的版本替換路由組件中的登錄和登出組件

const routesForNotAuthenticatedOnly = [
  {
    path: "/",
    element: <div>Home Page</div>,
  },
  {
    path: "/login",
    element: <Login />,
  },
];

在 routesForNotAuthenticatedOnly 數(shù)組中，“/login” 的 element 屬性設(shè)置為 <Login />，表示當(dāng)用戶訪問 “/login” 路徑時，會渲染 Login 組件

const routesForAuthenticatedOnly = [
  {
    path: "/",
    element: <ProtectedRoute />,
    children: [
      {
        path: "/",
        element: <div>User Home Page</div>,
      },
      {
        path: "/profile",
        element: <div>User Profile</div>,
      },
      {
        path: "/logout",
        element: <Logout />,
      },
    ],
  },
];

在 routesForAuthenticatedOnly 數(shù)組中，“/logout” 的 element 屬性設(shè)置為 <Logout />，表示當(dāng)用戶訪問 “/logout” 路徑時，會渲染 Logout 組件

測試流程

當(dāng)你第一次訪問根頁面 / 時，會看到 routesForNotAuthenticatedOnly 數(shù)組中的 “ Home page ”
如果你導(dǎo)航到 /login，在延遲 3 秒后，將模擬登錄過程。它將使用身份驗證上下文中的 setToken 函數(shù)設(shè)置測試令牌，然后你將被react-router-dom 庫中的導(dǎo)航函數(shù)重定向到根頁面 / 。重定向后，你將從 routesForAuthenticatedOnly 數(shù)組中看到 “User Home Page”
如果你隨后訪問 /logout，在延遲 3 秒后，將模擬登出過程。它將通過不帶任何參數(shù)調(diào)用 setToken 函數(shù)來清除身份驗證令牌，然后您將被重定向到根頁面 / 。由于你現(xiàn)在已登出，我們將從 routesForNotAuthenticatedOnly 數(shù)組中看到 “ Home Page ”。