Better Auth로 Next.js 인증 구현하기 — 세션 관리부터 관리자 권한까지

# 패키지 설치

npm install better-auth

lib/auth.ts — 서버 측 설정

import { betterAuth } from "better-auth";
import { drizzleAdapter } from "better-auth/adapters/drizzle";
import { db } from "./db";

export const auth = betterAuth({
  database: drizzleAdapter(db, { provider: "sqlite" }),
  emailAndPassword: {
    enabled: true,
    minPasswordLength: 8,
  },
  session: {
    expiresIn: 60 * 60 * 24 * 7,  // 7일
    updateAge: 60 * 60 * 24,       // 24시간마다 갱신
  },
});

lib/auth-client.ts — 클라이언트 측 설정

import { createAuthClient } from "better-auth/react";

export const authClient = createAuthClient({
  baseURL: process.env.NEXT_PUBLIC_SITE_URL,
});

export const { useSession, signIn, signUp, signOut } = authClient;

회원가입 예시

const handleSignUp = async () => {
  const result = await signUp.email({
    email: "user@example.com",
    password: "securePassword123",
    name: "홍길동",
  });

  if (result.error) {
    // 에러 처리 (이메일 중복 등)
    console.error(result.error.message);
  } else {
    // 회원가입 성공 → 자동 로그인
    router.push("/dashboard");
  }
};

로그인 예시

const handleSignIn = async () => {
  const result = await signIn.email({
    email: "user@example.com",
    password: "securePassword123",
  });

  if (result.error) {
    // 로그인 실패 처리
    setError("이메일 또는 비밀번호가 올바르지 않습니다.");
  } else {
    // 로그인 성공
    router.push("/dashboard");
  }
};

서버 컴포넌트에서 세션 확인

import { auth } from "@/lib/auth";
import { headers } from "next/headers";

export default async function DashboardPage() {
  const session = await auth.api.getSession({
    headers: await headers(),
  });

  if (!session) {
    redirect("/auth/login");
  }

  return <div>안녕하세요, {session.user.name}님</div>;
}

클라이언트 컴포넌트에서 세션 확인

"use client";
import { useSession, signOut } from "@/lib/auth-client";

export default function UserMenu() {
  const { data: session, isPending } = useSession();

  if (isPending) return <div>로딩 중...</div>;
  if (!session) return <Link href="/auth/login">로그인</Link>;

  return (
    <div>
      <span>{session.user.name}</span>
      <button onClick={() => signOut()}>로그아웃</button>
    </div>
  );
}

lib/admin-auth.ts — 관리자 검증 유틸

import { auth } from "@/lib/auth";
import { headers } from "next/headers";
import { NextResponse } from "next/server";

export async function requireAdmin() {
  const session = await auth.api.getSession({
    headers: await headers(),
  });

  if (!session || session.user.role !== "admin") {
    return null;
  }

  return session;
}

// API 라우트에서 사용
export async function adminGuard() {
  const session = await requireAdmin();
  if (!session) {
    return NextResponse.json(
      { error: "권한이 없습니다" },
      { status: 403 }
    );
  }
  return session;
}

관리자 전용 API 라우트 예시

// app/api/admin/members/route.ts
import { adminGuard } from "@/lib/admin-auth";

export async function GET() {
  const session = await adminGuard();
  if (session instanceof NextResponse) return session;

  // 관리자만 접근 가능한 로직
  const members = await db.select().from(users);
  return NextResponse.json({ members });
}