DynamoDB Number类型为何移除小数点后0？如何保留小数格式？

问题现象 #

测试DynamoDB Number类型时：
写入以下数据：

{
    "a": {
        "N": 1.25
    }
}

输出结果符合预期：

{ "a": 1.25 }

但写入：

{
    "b": {
        "N": 1.0
    }
}

输出结果变成：

{ "b": 1 }

小数点后的.0被自动移除，需要保留小数表示。

原因分析 #

DynamoDB的Number类型底层用字符串存储数值，但AWS SDK或客户端工具在序列化/反序列化时，会自动将其转换为对应编程语言的原生数值类型：

• 当数值是1.0这类可被表示为整数的浮点数时，客户端会自动将其转换为整数类型（比如Python的int、JavaScript的Number会做自动优化），从而丢失小数点后的.0。
• 核心原因是编程语言的数值类型系统会合并等价的整数和浮点数表示，而DynamoDB本身只存储数值的实际值，不保留格式信息。

解决方案 #

如果业务上必须明确保留.0的小数格式，有两种靠谱的处理方式：

1. 使用String类型存储 #

将数值以带格式的字符串存入DynamoDB的String类型（S字段），比如：

{
    "b": {
        "S": "1.0"
    }
}

读取时直接获取字符串即可完全保留格式，适用于对格式有严格要求的场景。

2. 自定义序列化逻辑 #

如果必须使用Number类型，可以通过自定义SDK的序列化器，强制将所有数值转换为带小数的字符串后再存入N字段：
比如在Python的boto3中，可以自定义类型转换器：

from boto3.dynamodb.types import TypeSerializer, TypeDeserializer

class CustomTypeSerializer(TypeSerializer):
    def serialize(self, value):
        if isinstance(value, float):
            # 强制保留至少一位小数
            return {'N': f"{value:.1f}"}
        return super().serialize(value)

# 使用自定义序列化器
serializer = CustomTypeSerializer()
item = serializer.serialize(1.0)
# 此时item为 {'N': '1.0'}

读取时再通过自定义反序列化器转换为带小数的浮点数，确保格式一致。

不推荐的方案 #

不要尝试通过添加极小值（比如1.0000001）来伪装小数格式，这会引入精度误差，可能导致后续数值计算出现问题。

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