React 폼 제어 비제어 전환 이해하기

헷갈리기 쉬운 상황

폼 제어 비제어 전환: 정상처럼 보이는 한 사례만으로는 동작 범위를 이해하기 어렵습니다. 대표 입력에서는 문제없다가 경계값, 느린 응답, 배포 직후처럼 조건이 달라질 때 결과가 바뀔 수 있습니다.

input value가 undefined에서 문자열로 바뀌면 uncontrolled에서 controlled로 전환되므로 초기값과 source of truth를 일관되게 유지해야 합니다.

핵심 원리

state, render, commit와 effect 수명주기로 구성된 React UI에서 어느 경계가 결과를 결정하는지 먼저 봅니다. render에서 계산할 값, 사용자가 소유한 state와 외부 시스템 동기화를 구분합니다. update를 시작한 값과 다시 update된 dependency를 따라가면 순환 원인을 찾을 수 있습니다.

구분	짧은 예시
기대 결과	폼 제어 비제어 전환: 정상 조건에서 사용자가 받아야 할 결과
실제 결과	같은 입력에서 처음 달라진 값·상태·오류
판별 자료	React Profiler, browser performance, network waterfall과 컴포넌트별 재렌더 원인을 확인한다

실무에서 확인할 것

파생값은 렌더에서 계산하고 외부 시스템 동기화만 Effect에 두며 상태를 가장 가까운 소유자에 둔다. 파생값은 가능한 한 render나 computed에서 계산하고 effect·watch는 외부 동기화에만 둡니다. 비동기 작업은 최신 요청 식별자나 취소 신호와 cleanup을 갖게 합니다.

대표 사례 하나, 값이 달라지는 경계 하나, 예상 가능한 실패 하나를 같은 순서로 확인합니다. Strict Mode, 느린 네트워크, 빠른 입력과 unmount 조건에서 렌더 비용과 cleanup을 검증한다. 초기 render, 연속 입력, 느린 응답의 순서 역전, unmount와 SSR hydration에서 state·DOM·cleanup이 기대한 순서로 바뀌는지 확인합니다.

공식 문서와 적용 범위

• React Documentation (새 창에서 열림)

문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.