DynamoDB ValidationException
TL;DR — ValidationException は、DynamoDB がデータに触れる 前に リクエストを不正な形式として拒否したことを意味します。メッセージのテキストを読んでください。問題のある正確なパラメータを示しています。何も書き込まれていないので、リクエストの形状を修正して再試行しましょう。
意味
ValidationException は、検証に失敗したリクエストに対する DynamoDB の総合的なクライアントエラー（HTTP 400）です。不正な式、誤った型ラッパー内の値、テーブルのスキーマと一致しないキー、または制限超過などです。リトライ不可 です。同じリクエストを再送しても同じエラーが生じます。
これはエラーのファミリーであるため、修正はメッセージ文字列に完全に依存します。最もよくある種類にはそれぞれ独自のページがあります:
- Query condition missed key schema element
- The provided key element does not match the schema
- UpdateExpression の構文が不正
- ExpressionAttributeValues contains invalid value
- Item size has exceeded the maximum allowed size
発生する理由
- パーティションキーを含まない、または非キー属性を参照する KeyConditionExpression。
- テーブル定義と型が一致しない キー属性（例: 数値を文字列として送る）。
- 不正な形式の UpdateExpression / ConditionExpression / FilterExpression — 予約語を素で使用、
#nameまたは:valueプレースホルダーの欠落。 - 許可されない場所での 空の値、またはサポートされない型に解決する属性。
- 制限超過 — 400 KB を超えるアイテム、
BatchWriteItem内のアイテムが多すぎる、式が長すぎる。
修正方法
- 完全なメッセージを読みます。 DynamoDB はどのパラメータが失敗したかを教えてくれます。文字列は正確です（"Invalid UpdateExpression: Attribute name is a reserved keyword; reserved keyword: status"）。
- 上記の種類に対応付け、そのページの修正を適用します。
- 送信前に リクエストの形状をローカルで検証します — ほとんどの
ValidationExceptionは式のタイプミスや型ラッパーです。
よくある質問
DynamoDB ValidationException はリトライ可能ですか？ いいえ。リクエスト自体が不正な形式なので、再送しても同じエラーが生じます。メッセージのテキストを読み — 問題のある正確なパラメータを示しています — リクエストの形状を修正してから再試行してください。
ValidationException の最もよくある原因は？ パーティションキーを省略するか非キー属性を参照する KeyConditionExpression、テーブル定義と型が一致しないキー属性、予約語やプレースホルダーの欠落を使った不正な形式の式、許可されない場所での空の値、または 400 KB を超えるアイテムのような制限超過です。
関連するエラー
- ConditionalCheckFailedException — 条件 が失敗した（不正な形式ではなく、書き込みは有効だが拒否された）。
- ResourceNotFoundException — テーブルまたはインデックスが存在しない。
- 学習: 式属性名と値 · Update Expression
参考資料
- Error handling with DynamoDB — Amazon DynamoDB Developer Guide
- Constraints in Amazon DynamoDB — Amazon DynamoDB Developer Guide
- Reserved words in DynamoDB — Amazon DynamoDB Developer Guide
最終検証日 2026-07-13、上記にリンクした公式 AWS ドキュメントに照らして確認しました。