Zarządzanie sesją i hook useSession
Uzyskiwanie dostępu do danych sesji w komponentach serwerowych i klienckich oraz ochrona stron na podstawie stanu uwierzytelnienia.
Zarządzanie sesją i hook useSession to bezpłatna lekcja React Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej React Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs React Academy zawiera 4 lekcji w sumie.
Typy sesji w Auth.js
Auth.js obsługuje dwie strategie sesji: JWT (domyślna, bezstanowy token w ciasteczku) oraz database (rekord sesji w bazie danych, który można unieważnić po stronie serwera).
useSession w Client Components
useSession() to hook Client Componentu odczytujący bieżącą sesję. Zwraca data (sesję), status ('loading' | 'authenticated' | 'unauthenticated') oraz funkcję update.
'use client';
import { useSession } from 'next-auth/react';
export function UserAvatar() {
const { data: session, status } = useSession();
if (status === 'loading') return <Spinner />;
if (status === 'unauthenticated') return <Link href="/login">Sign in</Link>;
return <img src={session.user?.image ?? ''} alt={session.user?.name ?? ''} />;
}Konfiguracja SessionProvider
Owiń aplikację (lub poddrzewo Client Componentów) w SessionProvider, aby useSession mógł uzyskać dostęp do kontekstu sesji.
// app/providers.tsx
'use client';
import { SessionProvider } from 'next-auth/react';
export function Providers({ children }: { children: React.ReactNode }) {
return <SessionProvider>{children}</SessionProvider>;
}
// app/layout.tsx
import { Providers } from './providers';
export default function RootLayout({ children }) {
return <html><body><Providers>{children}</Providers></body></html>;
}auth() w Server Components
W Server Components używaj bezpośrednio auth() — nie jest potrzebny ani hook, ani provider. Funkcja odczytuje sesję z ciasteczka po stronie serwera.
import { auth } from '@/auth';
export default async function Header() {
const session = await auth();
return (
<nav>
{session ? (
<span>Hello, {session.user?.name}</span>
) : (
<Link href="/login">Sign in</Link>
)}
</nav>
);
}Ochrona tras klienckich
Użyj useSession z opcją required: true, aby automatycznie przekierowywać nieuwierzytelnionych użytkowników na stronę logowania.
'use client';
import { useSession } from 'next-auth/react';
export default function ProtectedPage() {
const { data: session } = useSession({ required: true });
// session is never null here — unauthenticated users are redirected
return <div>Welcome, {session?.user?.name}</div>;
}Aktualizowanie sesji
Wywołaj funkcję update() zwracaną przez useSession, aby odświeżyć sesję (np. po aktualizacji profilu) bez wylogowywania i ponownego logowania.
const { data: session, update } = useSession();
async function handleNameChange(newName: string) {
await updateUserName(newName); // API call
await update({ user: { name: newName } }); // refresh session
}Callbacki sesji JWT
Użyj callbacka jwt, aby dodać niestandardowe dane do tokenu JWT podczas logowania, oraz callbacka session, aby udostępnić je w obiekcie sesji.
callbacks: {
async jwt({ token, user }) {
if (user) token.role = user.role; // add on first sign-in
return token;
},
async session({ session, token }) {
session.user.role = token.role as string;
return session;
},
},Wygaśnięcie sesji
Skonfiguruj maksymalny czas życia sesji w konfiguracji Auth.js. Aktywne sesje JWT są automatycznie odświeżane przy każdym żądaniu.
export const { handlers, auth } = NextAuth({
session: {
strategy: 'jwt',
maxAge: 30 * 24 * 60 * 60, // 30 days
updateAge: 24 * 60 * 60, // refresh if older than 1 day
},
});Unieważnianie sesji bazodanowych
Sesje bazodanowe można odwołać po stronie serwera (co jest przydatne przy wymuszonym wylogowaniu). Aby natychmiast je unieważnić, usuń rekord sesji z bazy danych.
// Server Action to log out all devices:
async function logOutAllDevices() {
'use server';
const session = await auth();
if (session) await db.session.deleteMany({ where: { userId: session.user.id } });
redirect('/login');
}Dostęp oparty na rolach w Client Components
Odczytaj rolę sesji za pomocą useSession i warunkowo renderuj interfejs na jej podstawie.
const { data: session } = useSession();
const isAdmin = session?.user?.role === 'admin';
return (
<>
{isAdmin && <AdminPanel />}
<UserContent />
</>
);Szybki test
Który provider musi opakowywać aplikację, aby useSession() działało w Client Components?
Podsumowanie
Używaj auth() do uzyskiwania dostępu do sesji w Server Components oraz useSession() w Client Components opakowanych przez SessionProvider. Dodawaj niestandardowe dane za pomocą callbacków JWT i sesji, aktualizuj sesje po stronie klienta przez update() i konfiguruj maxAge, aby określić wygaśnięcie sesji.
Często zadawane pytania
Czy lekcja „Zarządzanie sesją i hook useSession” jest bezpłatna?
Tak — pełny tekst „Zarządzanie sesją i hook useSession” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu React Academy, przejdź na CoddyKit PRO. Kurs React Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Zarządzanie sesją i hook useSession”?
Uzyskiwanie dostępu do danych sesji w komponentach serwerowych i klienckich oraz ochrona stron na podstawie stanu uwierzytelnienia. Ćwiczysz React Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć React Academy?
Nie wymagamy żadnego doświadczenia. React Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.
Ile czasu zajmuje lekcja „Zarządzanie sesją i hook useSession”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji React Academy?
Tak. Każda lekcja React Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Konfiguracja Auth.js w Next.js App Router
- Zarządzanie sesją i hook useSession
- Dostawca Credentials i niestandardowe logowanie
- Ochrona tras oparta na middleware