DynamoDB QuerySpec查询报错：条件参数类型不匹配Schema类型

问题现象 #

• 目标DynamoDB表分区键定义为Number类型，入参idNumber为字符串格式，代码中先将其转为long类型后传入QuerySpec查询，核心代码如下：

long queryId = Long.parseLong(idNumber);
    dynamoDBQuery = new QuerySpec()
            .withKeyConditionExpression(idType + " = :v_id")
            .withValueMap(new ValueMap()
                    .withLong(":v_id", queryId));

• 将.withLong()替换为.withNumber()传值后问题仍存在，执行时抛出如下异常：

"class": "com.amazonaws.services.dynamodbv2.model.AmazonDynamoDBException",
"message": "One or more parameter values were invalid: Condition parameter type does not match schema type (Service: AmazonDynamoDBv2; Status Code: 400; Error Code: ValidationException; Request ID: 9B9C943L42QUIHAVN2COS8D7F7VV4KQNSO5AEMVJF66Q9ASUAAJG; Proxy: null)"

排查顺序（按出现概率从高到低） #

• 校验分区键名是否正确
  先打印最终生成的键条件表达式，确认idType变量拼接出来的分区键名，和表实际定义的分区键名完全一致。80%的同类报错都是键名写错、变量传错导致的——如果键名不匹配，SDK会把传入的参数判定为非键字段参数，部分版本会直接抛出类型不匹配的误导性报错，和值的类型没有任何关系。不要用未校验的动态变量拼接键名，优先硬编码键名，或者提前对变量值做非空、合法值校验。
• 修正传值方式
  不管是.withLong()还是给.withNumber()传入long类型参数，都存在版本兼容问题：
  • DynamoDB的Number类型底层是高精度字符串存储，SDK的.withNumber()方法要求传入字符串格式的数字，不需要手动做类型转换。之前手动转long再传入的写法，在1.x版本的SDK中会被序列化为类型标记偏差的数值，触发校验失败。
  • 做表达式查询时，不要混用withLong/withInt这类强类型绑定方法，统一用.withNumber()传入原始字符串格式的id即可。
• 核对表配置与连接环境
  去控制台确认当前代码连接的目标表：
  • 确认没有连错环境（测试/生产）、错连其他同名异结构的表
  • 确认分区键确实是Number类型，没有被误配置为String类型——如果键实际是String类型，直接用.withString(":v_id", idNumber)传值即可。

修正后参考代码 #

// 不需要手动将idNumber转为long类型
dynamoDBQuery = new QuerySpec()
        // 替换为实际分区键名，不要用未校验的变量拼接
        .withKeyConditionExpression("实际分区键名 = :v_id")
        .withValueMap(new ValueMap()
                // 直接传入字符串格式的数字
                .withNumber(":v_id", idNumber));

内容的提问来源于stack exchange，提问作者faders