DynamoDB RequestLimitExceeded

요약 — 테이블 자체의 프로비저닝된 용량이 아니라 계정/테이블 수준 요청 속도 할당량을 초과했습니다. 온디맨드 테이블은 초당 40,000 읽기 요청 단위와 40,000 쓰기 요청 단위가 기본값입니다. SDK의 백오프 재시도를 유지하고, 트래픽이 실제라면 Service Quotas에서 할당량을 올리고, 단일 테이블/파티션이 병목이 되지 않도록 부하를 분산하세요.

무엇을 의미하는가

RequestLimitExceeded: Throughput exceeds the current throughput limit for your
account. To request a limit increase, contact AWS Support.

RequestLimitExceeded는 DynamoDB가 데이터 플레인에서 반환하는 세 가지 스로틀링 예외 중 하나입니다(ProvisionedThroughputExceededException, ThrottlingException과 함께). 이는 테이블별 프로비저닝된 RCU/WCU 상한이 아니라 계정 수준 서비스 할당량(예: 온디맨드 테이블의 테이블별 처리량 할당량)에 도달했음을 알립니다. HTTP 400을 반환하며 재시도할 수 있습니다 — SDK가 자동으로 백오프하고 재시도합니다. 오류는 ThrottlingReason 필드(예: TableWriteAccountLimitExceeded 또는 IndexReadAccountLimitExceeded)와 영향받은 리소스의 ARN을 지닙니다.

왜 발생하는가

• 온디맨드 테이블 기본 상한 — 각 온디맨드 테이블(과 그 각 GSI)은 초당 40,000 읽기 요청 단위와 40,000 쓰기 요청 단위의 조정 가능한 기본 할당량을 가집니다. 그것을 넘는 지속적인 소비는 할당량이 올라갈 때까지 계정 수준 ThrottlingReason으로 스로틀링됩니다.
• 테이블이 계정 할당량 아래에서 더 확장할 수 없음 — AWS 문서에 따르면 온디맨드 요청 속도가 허용된 계정 처리량을 초과하고 "테이블을 더 확장할 수 없습니다". 이 할당량은 안전장치이며 늘릴 수 있습니다.
• 새로 온디맨드가 된 테이블 워밍업 — 새 온디맨드 테이블(또는 방금 온디맨드로 전환된 것)은 이전 피크의 두 배까지 즉시 제공합니다. 그것을 훨씬 넘는 스파이크는 확장 전에 스로틀링될 수 있습니다.
• 최근 피크를 훨씬 넘는 트래픽 스파이크를 흡수하는 단일 핫 테이블.

어떻게 해결하는가

1. 지수 백오프 재시도를 켜두세요 — SDK 기본값이 일시적 스파이크를 처리합니다. 버스트 워크로드에는 적응형 재시도 모드를 사용하세요. 재시도를 비활성화하지 마세요.
2. 할당량을 올리세요 — 트래픽이 정당하고 지속적이라면 Service Quotas에서 테이블별 온디맨드 처리량(또는 계정 테이블 수/처리량 할당량) 증가를 요청하세요.
3. 알려진 스파이크 전에 사전 워밍하세요 — 곧바로 피크로 점프하기보다 트래픽을 램프업해 온디맨드 확장이 수요보다 앞서도록 하세요.
4. 부하를 분산하세요 — 핫 키를 샤딩하고 쓰기를 분산해 한 테이블/파티션이 전체 스파이크를 짊어지지 않도록 하세요(핫 파티션 패턴).
5. 핫 읽기를 캐시하세요(DAX나 앱 캐시)해 읽기 압력을 상한 아래로 덜어내세요.

FAQ

RequestLimitExceeded는 ProvisionedThroughputExceededException과 어떻게 다른가요? ProvisionedThroughputExceededException은 프로비저닝된 용량 테이블이 자체 구성된 RCU/WCU를 초과했다는 뜻입니다. RequestLimitExceeded는 단일 테이블의 테이블별 설정과 관계없이 계정 또는 테이블 수준 요청 속도 할당량 — 가장 흔하게는 초당 40,000 읽기와 40,000 쓰기 요청 단위의 온디맨드 기본값 — 에 도달했다는 뜻입니다.

RequestLimitExceeded는 재시도할 수 있나요? 네. 스로틀링 오류이며 AWS SDK가 지수 백오프로 자동 재시도합니다. 지속적인 발생은 더 많은 재시도가 아니라 할당량 증가나 부하 분산이 필요하다는 뜻입니다.

관련 오류

• ProvisionedThroughputExceededException — 테이블별 프로비저닝된 용량 초과.
• ThrottlingException — 제어 플레인 / 일반 속도 제한.
• 학습: On-demand vs provisioned · Hot partitions

참고 자료

• Error handling with DynamoDB — Amazon DynamoDB Developer Guide
• Quotas in Amazon DynamoDB — Amazon DynamoDB Developer Guide
• Troubleshooting throttling in Amazon DynamoDB — Amazon DynamoDB Developer Guide
• DynamoDB on-demand capacity mode — Amazon DynamoDB Developer Guide

공식 AWS 문서(위 링크)를 기준으로 2026-07-13에 마지막으로 검증되었습니다.