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 官方文件。