← 전체 글로 돌아가기

Next.js

React에서 key prop 문제로 폼 입력이 불편할 때

폼 입력이 이상하거나 리스트 아이템이 엉키는 문제는 대부분 key prop과 related. 재현 조건을 먼저 잡으면 빠르게 해결된다.

검색해서 들어온 상황이라면 바로 재현 조건부터 잡는 편이 빠르다. 한 단어만 붙잡지 말고 프론트엔드 UX 전체 흐름에서 원인을 좁혀야 한다.

증상을 재현할 수 있어야 한다

key 문제는 특정 조건에서만 나타난다. 먼저 그 조건을 정확히 파악해야 한다.

먼저 볼 값: 에러 문구

  • 콘솔에 경고가 있나?
  • 특정 조작 순서에서만 터나?
  • 로컬 환경과 배포 환경에서 다르게 나타나나?

이벤트 흐름을 추적하기

npm run build
# 브라우저에서 모바일 폭과 키보드 입력 흐름을 확인한다

key를 자체보다 재현 가능한 단서를 남기는 게 중요하다. 정상일 때의 프론트엔드 UX 상태를 기준으로 비교하면 다음으로 볼 범위가 확 줄어든다.

모바일 화면에서 확인

React 쪽 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나는 증거로 잡아야 한다.

남겨둘 기록:

  • 명령 출력
  • 응답 코드
  • 수정한 설정

검증 과정

  1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
  2. 콘솔이나 응답에서 바뀐 부분을 한 줄로 설명한다.
  3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

마지막에는 실제 화면이나 공개 URL까지 확인해야 작업이 끝난다. 관련 기록을 짧게라도 남겨두면 다음 확인이 훨씬 빨라진다.