표현식 크기가 최대 허용 크기를 초과했습니다.

TL;DR — DynamoDB는 단일 표현식 문자열을 4KB로 제한합니다(표현식 매개변수: UpdateExpression, ConditionExpression, FilterExpression, ProjectionExpression). 귀하의 제품은 그 이상으로 성장했습니다. 일반적으로 큰 항목이나 거대한 IN (…) / OR 필터에 대한 자동 생성 업데이트입니다. 항목이 아닌 표현을 축소하세요.

무엇을 의미하는가

ValidationException: 1 validation error detected: Invalid ConditionExpression: Expression size has exceeded the maximum allowed size; expression size: 27785

후행 바이트 수는 표현식의 측정된 크기이므로 요청마다 다릅니다.

4KB 한도는 항목의 400KB 크기와 관계없이 표현식 문자열 자체의 길이에 적용됩니다. SDK가 속성당 하나의 절을 작성하는 경우 400KB 미만의 항목은 여전히 표현식 예산을 오버플로할 수 있습니다(자세한 자리 표시자 이름이 빠르게 추가됨). HTTP 400 ValidationException입니다. 표현식을 변경하지 않으면 재시도할 수 없습니다.

표현식 예산에는 가장 먼저 칠 수 있는 형제가 있습니다. 각 #name/:value 자리 표시자는 255바이트로 제한되고, 결합된 ExpressionAttributeNames + ExpressionAttributeValues는 2MB, 단일 표현식은 300개의 연산자/함수, IN 비교기는 100개의 피연산자입니다.

왜 발생하는가

• 넓은 항목에 대해 자동 생성된 UpdateExpression — ORM/매퍼는 모든 속성에 대해 SET #a0 = :v0, #a1 = :v1, …를 내보내고 자리 표시자 이름과 구분 기호는 4KB를 넘습니다.
• 거대한 FilterExpression — 긴 attr IN (:0, :1, …) 또는 10개의 조건의 체인.
• 하나의 ConditionExpression에 많은 attribute_not_exists/비교가 포함된 대량 조건부 쓰기.
• 큰 항목의 콘솔 편집 — 큰 항목을 저장하면 큰 업데이트/조건 표현식이 다시 내보내집니다.

어떻게 해결하는가

1. 변경된 사항만 업데이트합니다. 전체 항목이 아닌 차이점에서 UpdateExpression을 빌드합니다. 대부분의 업데이트는 몇 가지 속성을 다룹니다.
2. 자리 표시자 이름을 줄이세요. #a/:v 설명이 긴 이름을 사용하세요. 중요한 길이는 표현식 문자열이므로 간결한 이름은 실제 헤드룸을 확보합니다.
3. 거대한 필터를 더 좁은 쿼리로 분할하거나 필터가 필요하지 않도록 재구성합니다(더 나은 키/인덱스는 더 적은 수의 16개 조건이 적용됨을 의미합니다).
4. 하나의 큰 쓰기를 여러 개의 작은 업데이트로 나누거나 단일 논리적 변경으로 인해 모든 항목이 다시 작성되지 않도록 항목을 모델링합니다.
5. 중첩 감소 — 깊게 중첩된 맵 경로는 표현식 길이를 증가시킵니다. 가능한 한 평평하게하십시오.
6. Cap IN은 100개의 피연산자로 나열됩니다. 이는 4KB 문자열 제한 이전에 실패할 수 있는 별도의 문서화된 제한입니다.

DynoTable에서

DynoTable은 항목의 모든 속성이 아닌 실제로 변경하는 필드에서 업데이트 표현식을 작성하여 표현식을 4KB 미만으로 유지합니다. ⌘K가 있는 항목을 열고, 특정 필드를 편집하고, 생성된 표현식 문자열 길이를 복사합니다.

절을 추가할 때 표현식 크기를 확인하려면 Expression Builder를 사용하세요. item size calculator은 넓은 항목이 자동 생성된 업데이트를 구동할 때 도움이 됩니다. ⌘P로 프로필을 전환합니다. Connect to AWS 및 Install를 참조하세요.

출처

• Constraints in Amazon DynamoDB (2026-07-13 검증)
• Using update expressions in DynamoDB (2026-07-13 검증)

관련 오류

• Item size exceeded the maximum (400 KB) — 표현이 아닌 항목이 너무 큽니다.
• Reserved keyword in attribute name — 애초에 자리 표시자가 필요한 이유.
• 학습: Update expressions · Filtering strategies

참고 자료

• Constraints in Amazon DynamoDB — Amazon DynamoDB Developer Guide
• Using update expressions in DynamoDB — Amazon DynamoDB Developer Guide
• Error handling with DynamoDB — Amazon DynamoDB Developer Guide

위에 링크된 공식 AWS 문서를 기준으로 2026년 7월 13일에 마지막으로 확인되었습니다.