Expression size has exceeded the maximum allowed size

TL;DR — DynamoDB 把任何单个表达式字符串限制在 4 KB（表达式参数：UpdateExpression、ConditionExpression、FilterExpression、ProjectionExpression）。你的超过了它——通常是对一个大项目自动生成的更新，或一个巨大的 IN (…) / OR 过滤器。缩短表达式，而不是项目。

含义

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

末尾那个字节数是实测出来的表达式大小，所以每个请求都不一样。

这个 4 KB 上限针对的是表达式字符串本身的长度，与项目的 400 KB 大小无关。如果 SDK 为每个属性构建一个子句，一个远小于 400 KB 的项目仍然可能溢出表达式预算（冗长的占位符名称累加得很快）。它是一个 HTTP 400 ValidationException——不改变表达式就不可重试。

表达式预算还有一些你可能先撞上的兄弟限制：每个 #name/:value 占位符上限为 255 字节，ExpressionAttributeNames + ExpressionAttributeValues 合计上限为 2 MB，单个表达式上限为 300 个运算符/函数，而一个 IN 比较器上限为 100 个操作数。

为什么会发生

对一个宽项目自动生成的 UpdateExpression——一个 ORM/mapper 为每个属性发出 SET #a0 = :v0, #a1 = :v1, …，占位符名称 + 分隔符越过了 4 KB。
一个巨大的 FilterExpression——一个长长的 attr IN (:0, :1, …) 或一串 OR 连接的条件。
批量条件写入，在一个 ConditionExpression 中有许多 attribute_not_exists/比较。
控制台对大项目的编辑——保存一个大项目会重新发出一个大的更新/条件表达式。

如何修复

只更新改变了的部分。 从差异而非整个项目构建 UpdateExpression——大多数更新只触及少数几个属性。
缩短占位符名称。 #a/:v 胜过长长的描述性名称；起作用的长度是表达式字符串，因此更简洁的名称能换来实实在在的余量。
拆分一个巨大的过滤器为更窄的查询，或重构使过滤器不再必要（更好的键/索引意味着更少的 OR 连接条件）。
把一个超大的写入拆成几个较小的更新，或者把项目建模成一次单一的逻辑变更不会重写所有内容。
减少嵌套——深度嵌套的 map 路径会膨胀表达式长度；能扁平化的地方就扁平化。

同时盯着项目和更新的大小？DynoTable 桌面应用呈现每个项目上的属性，因此当一次更新会触及远超所需的内容时会很明显。

从 DynoTable

DynoTable 从你实际更改的字段（而不是项目上的每个属性）构建更新表达式，使表达式远低于 4 KB。使用 ⌘K 打开项目，编辑特定字段，然后复制生成的表达式字符串长度。添加子句时，使用 Expression Builder 观察表达式大小。当宽项驱动自动生成的更新时，item size calculator 会有所帮助。使用 ⌘P 切换配置文件；参见连接 AWS和安装。

来源

Constraints in Amazon DynamoDB（2026-07-13 验证）
Using update expressions in DynamoDB（2026-07-13 验证）

参考资料

最后核实于 2026-07-13，依据上方链接的 AWS 官方文档。