Hyperlane 프레임워크를 활용한 캠퍼스 중고 거래 플랫폼 개발 경험

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

웹 개발

대상자

• 초보 Rust 개발자 및 웹 프레임워크 도입 고민 중인 개발자
• 난이도 기준: 중간 (Rust 기초 지식 필요, 복잡한 아키텍처 이해 필요 없음)

핵심 요약

• ctx.get_request_method().await와 같은 단순화된 API 호출으로 복잡한 메서드 계층 구조를 간소화
• 미들웨어 온리온 모델(ctx.aborted() 사용)을 통해 요청 흐름 제어 및 코드 중복 방지
• WebSocket 처리 시 ctx.closed()로 연결 종료 관리, wrk 테스트 시 320,000 QPS 달성 (Gin 대비 30% 성능 상승)

섹션별 세부 요약

1. 요청/응답 메서드 단순화

• 전통적 Rust 프레임워크의 ctx.get_request().await.get_method() 대신 ctx.get_request_method().await 사용
• 요청/응답 필드 이름 규칙 변경 (예: set_status_code → set_response_status_code)
• 문서 참조 없이도 메서드 계층 구조 이해 가능

2. 요청 메서드 매크로 사용

• #[methods(get, post)] 또는 #[get]으로 라우트 정의 가능
• #[postman] 오타 시 친화적인 에러 메시지 제공 (일반적인 컴파일 에러 대신)
• 라우트 작성 시 Markdown과 유사한 간결성 달성

3. 미들웨어 온리온 모델

• 요청 흐름: 클라이언트 → 인증 → 로깅 → 컨트롤러 → 응답 포맷 → 클라이언트
• ctx.aborted()로 미들웨어 중단 처리 (예: JWT 검증 실패 시)
• 미들웨어 순서 오류 시 로그로 오류 식별 가능 (예: 인증 미들웨어 이후 로깅 시 인증 오류 로그 발생)

4. WebSocket 처리

• ctx.closed()로 연결 종료 처리, 100명 동시 채팅 시 서버 리소스 안정성 유지
• Node.js 구현 대비 Hyperlane의 성능 우수성 확인 (50명 테스트 시 Node.js 서버 충돌)
• WebSocket 생명주기: 연결 → 핸드셰이크 → 콜백 → 미들웨어 → 메시지 처리

5. 동적 파라미터 및 정규표현식

• /goods/{id:\\d+}와 같은 정규표현식 사용 가능
• 잘못된 정규표현식 {id:\\D+} 시 404 에러 발생 (프레임워크 내부 라우트 오류 처리 기능)
• ctx.get_route_param("id").await.parse::()로 파라미터 변환 처리

6. 성능 테스트 결과

• wrk -c360 -d60s 명령어로 테스트, 320,000 QPS 달성
• Gin 대비 30% 성능 상승, Tokio 기반으로는 다소 느림
• 기본 설정으로 테스트 시 서버 최적화 없이도 성능 달성

7. 버전별 변경 사항

• v4.22.0 이후 ctx.aborted()로 요청 중단 가능 (게임의 "일시정지" 기능 유사)
• v5.25.1에서 ctx.closed()로 연결 종료 처리로 장기 연결 리소스 누수 해결
• 버전별 변경 내역을 생명주기 진화 차트로 명확히 표기

결론

• Hyperlane은 Rust 초보자도 쉽게 사용 가능하며, 학생 개발자에게 친화적인 문서 예제 제공
• WebSocket 처리 및 미들웨어 관리 기능으로 실무적 성능과 안정성 확보
• wrk 테스트 시 320,000 QPS 달성으로 Gin 대비 30% 성능 우위, Tokio 기반으로도 충분한 성능 제공
• "블록 조립식" 개발 경험으로 프로그래밍 재미 증대, Rust 웹 프로젝트 개발 시 강력히 추천