使用Terraform向DynamoDB写入数据时遇ValidationException错误求助

架构老林

2026-7-25

错误原因分析

这个ValidationException错误的核心是Terraform在读取/写入DynamoDB条目时，无法匹配表的主键Schema，具体诱因包括：

Heredoc格式的JSON存在隐藏问题：你使用的<<ITEM heredoc可能包含不可见的空格、换行或格式错误，导致Terraform解析item时无法正确识别range键process_key的值，进而构建了不完整的主键（错误信息中range键位置为空）。
资源依赖未自动建立：硬编码表名、hash键和range键的写法，让Terraform无法感知aws_dynamodb_table与aws_dynamodb_table_item的依赖关系，可能在表未完全创建就绪时就尝试写入条目，此时表的Schema尚未生效。
旧版本AWS Provider存在兼容性bug：较老版本的Terraform AWS Provider对复合主键（hash+range）的处理可能存在缺陷，导致主键匹配失败。

解决办法

1. 改用`jsonencode`构建条目内容

替换heredoc格式的JSON为Terraform的jsonencode函数，确保JSON格式绝对正确，避免解析错误：

resource "aws_dynamodb_table_item" "control-tower_execution_STG_TJOB" {
  table_name = aws_dynamodb_table.snflk_execution_process_details.name
  hash_key   = aws_dynamodb_table.snflk_execution_process_details.hash_key
  range_key  = aws_dynamodb_table.snflk_execution_process_details.range_key
  item = jsonencode({
    execution_key = { S = "control-tower_execution" },
    process_key = { S = "STG_TJOB" },
    application = { S = "control_tower" },
    batch = { N = "1" },
    scripts = { S = "control-tower/sf-trf/STG_TJOB.sql" },
    sql_dict = { S = "None" },
    target_table_name = { S = "STG_TJOB" }
  })
}

2. 显式强制资源依赖（可选，推荐）

如果自动依赖仍不生效，添加depends_on强制等待表创建完成后再写入条目：

resource "aws_dynamodb_table_item" "control-tower_execution_STG_TJOB" {
  table_name = aws_dynamodb_table.snflk_execution_process_details.name
  hash_key   = aws_dynamodb_table.snflk_execution_process_details.hash_key
  range_key  = aws_dynamodb_table.snflk_execution_process_details.range_key
  item = jsonencode({
    execution_key = { S = "control-tower_execution" },
    process_key = { S = "STG_TJOB" },
    application = { S = "control_tower" },
    batch = { N = "1" },
    scripts = { S = "control-tower/sf-trf/STG_TJOB.sql" },
    sql_dict = { S = "None" },
    target_table_name = { S = "STG_TJOB" }
  })
  
  depends_on = [aws_dynamodb_table.snflk_execution_process_details]
}

3. 升级Terraform AWS Provider到最新版本

在配置中指定最新版本的AWS Provider，执行terraform init -upgrade完成升级：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = ">= 5.0.0"
    }
  }
}

4. 清理异常状态（如果之前的错误导致状态残留）

若Terraform状态中存在异常的条目记录，先移除再重新部署：

terraform state rm aws_dynamodb_table_item.control-tower_execution_STG_TJOB
terraform apply

内容的提问来源于stack exchange，提问作者Ravishankar Thavam Thevar