27장. NestJS 11과 Express 5 라우팅을 점검한다

NestJS 11의 Express adapter는 Express 5를 기본으로 하므로 wildcard와 optional path 문법을 migration test로 확인한다. 이름 없는 * 대신 /*splat 또는 필요한 경우 /{*splat}을 사용하고, ? optional segment에 의존한 route는 braces 또는 명시적 route로 바꾼다. 정규식 기호가 섞인 기존 route와 middleware 적용 범위를 목록화한다.

upgrade branch에서 전체 endpoint를 OpenAPI와 access log에서 추출하고 정상·404·method-not-allowed를 contract test한다. global middleware와 module middleware 실행 순서도 11에서 의도대로인지 correlation log로 확인한다. fallback route가 API 오류를 HTML 200으로 삼키지 않게 한다.

Fastify adapter를 쓰면 Express 예제를 그대로 적용하지 않는다. NestJS 11의 Fastify 5 지원, CORS method 명시, middleware wildcard 차이를 별 matrix로 시험한다. adapter 전환은 성능 설정 하나가 아니라 plugin·error·body limit·upload·observability 계약 변경이다.