AWS Serverless 기반 CRUD 구축 및 설정 오류 8건의 기술적 해결

I Spent 6 Hours Debugging AWS Before Realising the Bug Was a Capital Letter

Edith Asante2026년 5월 13일9분beginner

AI 요약

Context

AWS Free Tier 범위 내에서 확장 가능한 학생 기록 관리 시스템 구축을 위해 Serverless 아키텍처를 채택함. 초기 설계 시 코드 로직보다 인프라 설정 및 서비스 간 권한 제어에서 발생하는 병목 지점이 주요 장애 요인으로 작용함.

S3 기반 Static Website 호스팅을 통한 프론트엔드 배포 및 API Gateway를 통한 REST API 인터페이스 구축
Lambda-DynamoDB 간 연결을 위해 IAM Execution Role에 AmazonDynamoDBFullAccess 권한을 명시적으로 부여한 보안 설계
DynamoDB의 Decimal 타입 데이터를 JSON으로 직렬화하기 위해 Custom DecimalEncoder 클래스를 구현한 데이터 처리 로직 적용
API Gateway의 Lambda Proxy Integration을 활성화하여 요청/응답 페이로드를 Lambda 함수로 직접 전달하는 구조 설계
Case-sensitive한 AWS 리소스 경로 특성에 따른 API 엔드포인트 명명 규칙 통일로 404 에러 해결

실천 포인트

1. API Gateway 변경 사항 적용 후 반드시 Stage 재배포 수행 여부 확인

2. Lambda-DB 통신 장애 시 IAM Role의 최소 권한 원칙 기반 정책 검토

3. DynamoDB 숫자형 데이터 처리 시 Decimal to Float 변환 로직 포함 여부 체크

4. S3 정적 웹사이트 업데이트 후 브라우저 캐시 무효화를 위한 Hard Refresh 적용

태그