01백엔드
2026년 7월KYB 기업심사 REST API
Go + Echo 기반 멀티테넌트 KYB(Know Your Business) 심사 플랫폼. 기업 등록부터 3단계 심사, WLF 스크리닝, 재제출 워크플로까지 지원.
이 프로젝트에서의 Echo 활용
HTTP 라우팅 및 미들웨어 프레임워크 (v4)
kyb-api프로젝트 자세히 보기 →
기술스택 목록
프레임워크
Echo
프로젝트 1개에서 사용했습니다. 각 프로젝트에서 어떤 역할로 썼는지 아래에 정리했습니다.
이 기술은 무엇인가요?
Go 언어로 작성된 고성능 웹 프레임워크
Echo는 Go 언어 기반의 경량 웹 프레임워크로, RESTful API 서버를 빠르게 구축할 수 있도록 설계되었습니다. 표준 net/http 패키지를 기반으로 하되, 라우팅·미들웨어·컨텍스트 처리 등을 간결한 API로 제공하여 개발 생산성을 높입니다. 최소한의 메모리 할당과 빠른 라우팅 성능에 중점을 두고 있습니다.
이럴 때 사용합니다
- Go로 RESTful API 서버를 빠르게 구축해야 할 때
- 표준 라이브러리보다 간결한 라우팅·미들웨어 API가 필요할 때
- 높은 처리량과 낮은 메모리 사용이 중요한 서비스
- JSON 응답 중심의 마이크로서비스 백엔드
핵심 개념
- Handler
- 특정 HTTP 요청을 처리하는 함수입니다. Echo.Context를 인자로 받아 응답을 반환합니다.
- Context
- 요청·응답 객체와 경로 파라미터, 쿼리스트링 등을 담고 있는 Echo 전용 컨텍스트입니다. 핸들러와 미들웨어 간에 값을 전달하는 용도로도 사용됩니다.
- Middleware
- 핸들러 실행 전후로 공통 로직(로깅, 인증, CORS 등)을 처리하는 함수입니다. 체인 형태로 연결할 수 있습니다.
- Router
- URL 경로와 HTTP 메서드를 핸들러에 매핑하는 라우팅 엔진입니다. 경로 파라미터와 와일드카드를 지원합니다.
- Group
- 공통 prefix나 미들웨어를 가진 라우트들을 묶어 관리하는 단위입니다. /api/v1 같은 버전별 라우팅을 구조화할 때 유용합니다.
기본 Echo 서버
미들웨어를 등록하고, 루트 경로와 파라미터를 받는 경로에 핸들러를 연결한 뒤 8080 포트에서 서버를 시작하는 예시입니다.
Go
package main
import (
"net/http"
"github.com/labstack/echo/v4"
"github.com/labstack/echo/v4/middleware"
)
func main() {
e := echo.New()
// 미들웨어 등록
e.Use(middleware.Logger())
e.Use(middleware.Recover())
// 라우트 정의
e.GET("/", func(c echo.Context) error {
return c.JSON(http.StatusOK, map[string]string{"message": "Hello, Echo"})
})
e.GET("/users/:id", func(c echo.Context) error {
id := c.Param("id")
return c.String(http.StatusOK, "User ID: "+id)
})
e.Start(":8080")
}처음 쓸 때 흔한 함정
- Context를 고루틴 안에서 직접 사용하면 race condition이 발생할 수 있습니다
- 커스텀 에러 핸들러를 등록하지 않으면 기본 에러 응답 형식이 노출됩니다
- 미들웨어 등록 순서에 따라 실행 순서가 달라지므로 인증·로깅 순서에 주의해야 합니다
위 개요는 기술 학습을 돕기 위해 자동 생성된 일반 설명입니다. 정확한 사양과 최신 정보는 공식 문서를 확인하세요.
프로젝트별 활용 방식
위 개념이 실제 프로젝트에서 어떻게 쓰였는지 보여줍니다.
함께 사용한 기술
위 프로젝트들에서 같이 쓰인 다른 기술입니다.