gRPC + Spring Boot 완주 가이드. 추천 읽기 순서와 전체 목차.
📚 심화 · 통신 · 10편
gRPC + Spring Boot
HTTP/2 + Protocol Buffers 기반의 고성능 다중 언어 RPC 프레임워크. 기본 개념부터 Protobuf·4가지 RPC 모드(Unary·서버 스트리밍·클라이언트 스트리밍·Bidirectional)·Interceptor·Error Handling·보안·고급 운영까지 10편으로 풀어쓴 심화 학습 자료입니다.
어떤 분이 읽으면 좋아요
이 시리즈는 마이크로서비스 간 고성능 RPC 통신이 필요하거나, REST API 대비 타입 안전성을 원하는 백엔드 개발자를 염두에 두고 썼어요. Java·Go·Python 등 다중 언어 팀에서 계약(contract) 기반 통신이 필요할 때 gRPC가 강점입니다. Protobuf의 IDL 방식이 생소하더라도 3편부터 단계별로 익히면 충분합니다.
처음 들어오신 분은 1편(기본 개념·HTTP/2·4 RPC 모드)→ 7편(Protobuf)→ 4편(Unary RPC) 순서로 첫 gRPC 서버·클라이언트를 만들어보세요. 스트리밍이 목표라면 5편(서버 스트리밍)→ 6편(클라이언트 스트리밍)→ 3편(Bidirectional) 순서로, 운영 준비라면 8편(Error Handling)→ 2편(Interceptor)→ 9편(보안)을 이어 읽으세요.
추천 읽기 순서
- gRPC 입문 → 1편(기본 개념·HTTP/2·4 RPC 모드) → 7편(Protobuf) → 4편(Unary RPC)
- 스트리밍 구현 → 5편(서버 스트리밍) → 6편(클라이언트 스트리밍) → 3편(Bidirectional)
- 운영·품질 자리 → 8편(Error Handling·Status Codes) → 2편(Interceptors) → 9편(보안·TLS·인증)
- 고급 운영 → 10편(Reflection·Health·Load Balancing·gRPC-Web)
전체 목차
| 편 | 제목 | 핵심 |
|---|---|---|
| 1편 | 기본 개념·HTTP/2·4 RPC 모드 | gRPC vs REST·HTTP/2 멀티플렉싱·스텁 |
| 2편 | Interceptors | ServerInterceptor·ClientInterceptor·로깅·인증 |
| 3편 | Bidirectional Streaming | 양방향 스트리밍·StreamObserver·채팅 패턴 |
| 4편 | Unary RPC | 단순 요청-응답·@GrpcService·Stub 호출 |
| 5편 | Server Streaming | 서버 → 클라이언트 스트림·onNext·onCompleted |
| 6편 | Client Streaming | 클라이언트 → 서버 스트림·StreamObserver 패턴 |
| 7편 | Protocol Buffers (Protobuf) | .proto 스키마·직렬화·버전 호환성·코드 생성 |
| 8편 | Error Handling·Status Codes | Status·StatusException·Metadata·에러 전파 |
| 9편 | Security·TLS·인증 | TLS·mTLS·JWT 인터셉터·OAuth2 |
| 10편 | 고급 (Reflection·Health·LB·gRPC-Web) | Server Reflection·Health Check·gRPC-Web·k8s LB |
다음 단계
gRPC로 타입 안전 바이너리 RPC를 익혔다면, 클라이언트가 필요한 필드만 요청할 수 있는 GraphQL이 자연스러운 다음 학습입니다. 전체 시리즈 로드맵은 series 페이지에서 확인하세요.
- Reactive GraphQL — 완주 가이드 (Spring for GraphQL·Subscription·DataLoader)
- Spring RSocket 마스터 — 완주 가이드 (리액티브 바이너리 프로토콜)
- 전체 시리즈 로드맵