Overview

대정유통 - 홍게 판매 커머스 웹사이트 (2026.10)

울진 홍게를 판매하는 대정유통의 커머스 웹사이트입니다. 상품 소개, 회원 기능, 고객문의 게시판을 React와 Spring Boot로 구현하고 실제 도메인에 배포했습니다.

Tech Stack

Frontend

- React 19, TypeScript, Vite, React Router, TanStack Query, Zustand, Axios, Tailwind CSS

Backend

- Java 17, Spring Boot, Spring Security, Spring Data JPA, JWT

Database

- MySQL, Redis

Infra / DevOps

- Docker, Docker Compose, GitHub Actions, GHCR, Vercel

Features

상품

- 자동으로 넘어가고 스와이프로 넘길 수 있는 홈 배너

- 상품 목록과 상세 페이지(상품 정보, 배송·교환·반품 안내 탭)

회원

- 회원가입, 로그인, 로그아웃, 새로고침 후에도 로그인 유지

- 회원 정보 조회·수정, Daum 우편번호 검색을 이용한 배송지 관리

고객문의 게시판

- 공지사항, 제목·작성자 검색, 페이지네이션, 조회수

- 게시글 작성·수정·삭제와 댓글 작성·삭제

서버 점검 안내

- 서버에 연결할 수 없을 때 점검 안내 페이지 표시

Implementation

JWT 인증과 토큰 보관

로그인 상태를 안전하게 지키면서도 새로고침할 때마다 다시 로그인하지 않도록, Access Token과 Refresh Token의 역할과 보관 위치를 나눴습니다.

- Access Token은 localStorage 대신 메모리(Zustand)에만 두어 XSS로 탈취될 위험을 줄였습니다.

- Refresh Token은 HttpOnly·SameSite 쿠키에 담고, 쿠키 경로를 인증 API(/api/v1/auth)로 제한해 다른 요청에는 실리지 않게 했습니다.

- Refresh Token은 Redis에 TTL과 함께 저장하고, 재발급할 때마다 기존 토큰을 지우고 새로 발급(Rotation)해 한 번 쓴 토큰은 다시 쓸 수 없게 했습니다.

- Access Token과 Refresh Token의 서명 키를 분리했고, 토큰 저장소를 인터페이스로 추상화해 설정값으로 Redis와 인메모리 저장소를 바꿔 쓸 수 있게 했습니다.

토큰 자동 재발급

Access Token이 만료되어도 사용자가 알아차리지 못하도록 Axios 인터셉터에서 재발급과 재요청을 처리했습니다.

- 401 응답을 받으면 토큰을 재발급한 뒤 실패했던 요청을 한 번 더 보냅니다.

- 여러 요청이 동시에 401을 받아도 재발급 요청은 한 번만 나가도록, 진행 중인 재발급 Promise를 공유했습니다.

- 재발급 요청은 인터셉터가 없는 별도 Axios 인스턴스로 보내 무한 루프를 막았습니다.

- 새로고침 직후에는 세션 복구가 끝날 때까지 다른 요청을 기다리게 해, 토큰 없이 요청이 나가는 상황을 없앴습니다.

게시판 조회 성능과 정확성

고객문의 게시판은 목록, 상세, 댓글을 조회할 때마다 작성자 정보가 함께 필요해 쿼리가 늘어나기 쉬운 구조였습니다.

- @EntityGraph로 게시글과 작성자를 한 번에 조회해 N+1 문제를 막았습니다.

- 조회수는 엔티티 값을 바꾸는 대신 벌크 UPDATE 쿼리로 DB에서 직접 올려, 여러 사람이 동시에 조회해도 누락되지 않게 했습니다.

- 공지사항은 일반 게시글 목록과 분리해 따로 내려주고, 검색은 제목·작성자·전체 범위를 지원합니다.

서버 상태와 클라이언트 상태 분리

서버에서 받아오는 데이터는 TanStack Query로, 로그인 정보처럼 브라우저에서만 쓰는 값은 Zustand로 나눠 관리했습니다.

- 게시판 쿼리 키를 계층 구조로 설계해, 글을 쓰거나 지운 뒤 관련 목록 캐시를 한 번에 무효화합니다.

- 페이지를 넘길 때 이전 결과를 유지해, 표가 비었다가 다시 채워지는 깜빡임을 없앴습니다.

- 회원 정보 수정과 배송지 관리 페이지가 같은 캐시를 보도록 회원 정보 조회를 한곳에 모았습니다.

권한 관리

누가 어떤 기능을 쓸 수 있는지를 서버와 화면 양쪽에서 확인하도록 했습니다.

- Spring Security에서 공개, 회원, 관리자(ADMIN) API를 경로별로 구분했습니다.

- 게시글과 댓글은 작성자 본인과 관리자만 수정·삭제할 수 있도록 서비스 계층에서 검사합니다.

- 로그인이 필요한 페이지는 ProtectedRoute로 막고, 로그인한 뒤 원래 가려던 페이지로 돌려보냅니다.

서버 장애 대응

서버가 내려가 있을 때 빈 화면이나 알 수 없는 오류 대신 안내 페이지를 보여주도록 했습니다.

- 응답이 아예 없거나 502·503·504 응답을 받으면 서버 점검 페이지로 전환합니다.

- 사용자 기기의 인터넷이 끊긴 경우는 서버 문제가 아니므로 판단에서 제외했습니다.

SEO

검색으로 사이트를 찾아올 수 있도록, 페이지가 하나뿐인 SPA의 한계를 보완하는 설정을 했습니다.

- 모든 페이지가 같은 index.html을 쓰기 때문에, 페이지마다 canonical 태그로 대표 주소를 따로 알려줍니다.

- sitemap, robots.txt(로그인이 필요한 페이지 제외), Open Graph 태그를 설정하고 네이버 서치어드바이저에 사이트를 등록했습니다.

배포와 개발 환경

코드를 병합하면 배포용 이미지가 자동으로 만들어지도록 하고, 로컬과 운영 환경의 설정을 분리했습니다.

- main 브랜치에 PR이 병합되면 GitHub Actions가 Gradle로 빌드하고 Docker 이미지를 GHCR에 푸시합니다.

- 멀티 스테이지 Dockerfile로 빌드 환경과 실행 환경을 나눴습니다.

- Docker Compose로 MySQL과 Redis를 띄우고, Spring 프로필(local, prod)로 DB 주소, CORS 허용 도메인, 쿠키 Secure 옵션을 환경별로 나눴습니다.

- 프론트엔드는 Vercel로 배포하고, 인증·고객문의·보안 설정·오류 응답에 대한 통합 테스트를 작성했습니다.

Troubleshooting

인증 실패가 401이 아닌 403으로 응답되는 문제

- 문제: 만료된 Access Token으로 요청하면 403이 응답되어, 401을 기준으로 동작하는 프론트엔드의 토큰 재발급이 실행되지 않았습니다.

- 원인: formLogin과 httpBasic을 쓰지 않는 Stateless 설정에서는 인증에 실패해도 Spring Security가 기본으로 403을 응답합니다.

- 해결: AuthenticationEntryPoint를 HttpStatusEntryPoint(401)로 지정해 "인증 실패(401)"와 "권한 없음(403)"을 구분했습니다.

모든 오류 응답이 403으로 바뀌는 문제

- 문제: 없는 게시글(404)이나 잘못된 요청(400)처럼 어떤 오류가 나도 클라이언트에는 403만 전달되었습니다.

- 원인: 오류가 나면 Spring이 요청을 /error 경로로 다시 보내는데, 이때는 JWT 필터가 실행되지 않아 인증되지 않은 요청으로 막혔습니다.

- 해결: /error 경로를 permitAll로 열어 원래의 오류 상태 코드가 그대로 전달되도록 했습니다.