본문 바로가기
Q&A해결2026년 4월 20일1분 읽기

React Server Components에서 Context Provider가 동작하지 않습니다

풀
풀스택신입
조회 916댓글 1

Next.js 16 App Router로 마이그레이션 중인데, 기존 ThemeContext를 RSC 안에서 쓰려고 하니까 동작 자체를 안 합니다.

구조는 app/layout.tsx에서 ThemeProvider로 감쌌고, RSC인 app/page.tsx 안에서 useContext(ThemeContext) 호출하니 "Cannot read properties of null"이 떨어집니다.

Provider는 'use client'를 붙여서 클라이언트 컴포넌트로 만들었는데도 RSC에서 못 가져오네요. 어떻게 처리해야 하나요?

댓글 1

김김영삼7개월 전

Server Components에서는 React Context를 그대로 사용할 수 없습니다. Context는 런타임에 컴포넌트 트리 안에서만 의미가 있는데, Server Components는 빌드/요청 시 서버에서 직렬화되어 내려오기 때문입니다.

핵심 정리:

  • 'use client' 가 붙은 Provider는 클라이언트 트리에서만 살아 있다
  • Server Component는 그 트리 바깥(상위)에 있는 셈이라 useContext를 호출할 수 없다
  • "Provider로 감쌌으니 안에서 다 쓸 수 있다"는 것은 클라이언트 한정 가정이다

실무 해결 패턴 3가지:

1) 데이터를 props로 내려준다 (가장 깔끔)

// app/page.tsx (Server Component)
import { getTheme } from '@/lib/theme'
import ClientView from './ClientView'

export default async function Page() {
const theme = await getTheme() // 서버에서 직접 결정
return <ClientView theme={theme} />
}

2) Server-only context (cache + headers/cookies)

// lib/theme.ts
import { cache } from 'react'
import { cookies } from 'next/headers'

export const getTheme = cache(async () => {
const c = (await cookies()).get('theme')?.value
return c === 'dark' ? 'dark' : 'light'
})

Next.js의 cookies()·headers()가 서버에서의 사실상의 컨텍스트 역할을 합니다. cache()로 감싸면 같은 요청 내 중복 호출이 묶입니다.

3) 클라이언트 경계로 분리

Theme이 정말 클라이언트 트리 안에서만 필요하다면, 해당 영역만 Client Component로 분리하고 그 안에서 useContext를 사용하면 됩니다.

주의 사항:

  • Provider 컴포넌트 자체가 'use client'라도, 그것을 import한 부모(Server Component) 트리에서는 Context가 보이지 않습니다
  • "전역 상태"라는 개념을 RSC에서는 cookies/searchParams/DB로 옮기는 것이 맞습니다
  • Zustand·Jotai 같은 글로벌 스토어도 동일 — 클라이언트 한정

실무에서는 1번(props)으로 시작하고, 클라이언트 측 상호작용이 진짜 필요한 곳만 Client Component로 분리하는 흐름이 가장 안전합니다.

Ctrl+Enter로 등록