Next.js streaming 프록시 버퍼링, 완료를 판단하는 검증 기준

검증할 문제

streaming 프록시 버퍼링에서 유지해야 할 동작과 바뀌어야 할 결과를 나눠 적습니다. Next.js가 chunk를 streaming해도 reverse proxy가 buffering하면 browser에는 한 번에 도착할 수 있습니다.

원인과 테스트 조건

DNS, TCP, TLS, proxy와 application 구간을 나눠 connect·header·response 시간을 측정합니다. 마지막에 보인 HTTP status 하나로 실패 지점을 추측하지 않습니다.

조건	확인할 내용
대표 사례	자주 쓰는 조건에서 기대 결과가 나오는가
경계	값이나 동작이 바뀌는 지점이 안전한가
실패	오류가 정해진 방식으로 드러나고 중간 상태가 남지 않는가
반복	다시 실행해도 결과가 예측 가능한가

통과 기준과 안전망

수정 전 실패 사례는 사라지고 기존 정상 사례는 유지돼야 합니다. 프로덕션 빌드에서 정적·동적 route, 번들 크기, TTFB, 캐시 적중과 관리자 변경 직후 일관성을 확인한다. 지연, 연결 거절, 중간 종료와 DNS 변경을 주입해 오류가 제한 시간 안에 분류되고 socket이 반환되는지 확인합니다. 한 번의 가장 좋은 결과나 화면 한 장으로 완료를 선언하지 않습니다. 실패 입력과 기대 결과를 자동 test나 실행 가능한 점검으로 남깁니다.

공식 문서와 적용 범위

• Next.js Documentation (새 창에서 열림)

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