Next.js 15에서 16으로 올렸더니 갑자기 hydration mismatch 에러가 여기저기서 터집니다. 특히 new Date().toLocaleString() 쓰는 부분에서 다 터지는데, 15에서는 멀쩡했거든요.
이게 16의 변경 때문인가요? 아니면 원래 잘못된 코드였는데 16에서 더 엄격하게 잡는 건가요?
// 에러 나는 컴포넌트
'use client'
export default function Timestamp({ date }: { date: Date }) {
return <time>{date.toLocaleString('ko-KR')}</time>
}
댓글 2
16에서 더 엄격해졌습니다. 정확히는 React 19.2에서 hydration mismatch 검출 로직이 정교해졌고, Next.js 16이 이를 그대로 노출합니다. 이전엔 조용히 넘어가던 케이스가 이제 경고로 잡힙니다.
원인 — 서버와 클라이언트의 locale
toLocaleString결과 생성해결책 — 3가지 중 선택
1) ISO 문자열로 서버에서 보내고 클라이언트에서만 포맷
2) suppressHydrationWarning (간단하지만 마지막 수단)
3) 서버에서도 같은 timezone 강제
1번을 권장합니다. SEO 측면에서 ISO 문자열이
<time dateTime>으로 들어가고, 사용자에게는 로컬 시간으로 보입니다. 구글이 가장 정확히 이해하는 방식이에요.