The provided expression refers to an attribute that does not exist in the item
TL;DR — 你的 UpdateExpression 读取了一个不在项目上的属性——一个算术操作数（SET score = score + :inc，而 score 从未被设置过）、一次从另一个属性的复制（SET a = b），或者一个 list_append，其 list 操作数缺失。用 if_not_exists 守护该读取，或在创建项目时播种该属性。（向一个父级 map 缺失的嵌套路径写入会引发另一个"document path invalid for update" 错误。）
含义
ValidationException: The provided expression refers to an attribute
that does not exist in the item这是一个 HTTP 400 ValidationException。请求解析得没问题，但当 DynamoDB 针对项目对它求值时，你表达式读取的某个属性——+/- 的一个操作数、SET a = b 复制的源，或一个 list_append 参数——不在那里，因此操作数无法解析。它是客户端错误且不可重试：同样的项目 + 表达式会重现它。
为什么会发生
- 对未设置的属性做算术——
SET score = score + :inc在score从未初始化时会抛出；文档的自增/自减语法作用于一个_已存在的_数值属性。 - 从一个缺失的属性复制——
SET backupEmail = email，而项目没有email。 - 对一个缺失的 list 做
list_append——SET tags = list_append(tags, :more)，而tags尚不存在。 - 嵌套路径的占位符映射错误——把整条点分路径映射进一个
ExpressionAttributeNames条目（"#p": "stats.viewCount"），而不是只替换叶子；DynamoDB 把字面的"stats.viewCount"当作单个属性名，它在表达式读取时就是缺失的。 - 读取属性名中的拼写错误或大小写错误——DynamoDB 属性名区分大小写。
如何修复
- 用
if_not_exists守护读取，让第一次写入即使在属性还不存在时也能工作：SET score = if_not_exists(score, :zero) + :inc SET tags = list_append(if_not_exists(tags, :emptyList), :more) - 在创建项目时播种该属性——预先写入
score: 0、tags: []，让后续读取总能解析。 - 在嵌套路径中只替换叶子——在表达式中让点保持字面：
SET stats.#c = :v配上{"#c": "viewCount"}，而不是把整条路径放进一个名称里。 - 在假定路径有效之前，用
GetItem核实属性存在/拼写 + 大小写。 - 在写入一个父级 map 缺失的嵌套子级？ 那是兄弟错误——关于两步式创建父级的模式，参见 the document path provided in the update expression is invalid for update。
想在编写更新时把项目的真实形态摆在眼前？DynoTable 桌面应用会显示每一个属性（包括嵌套的 map 和 list），因此一条缺失的父级路径一眼就能看出。
相关错误
- The document path provided in the update expression is invalid for update——向一个父级 map/list 缺失或类型错误的嵌套路径写入。
- UpdateExpression 语法无效——表达式本身格式错误，在这个检查之前就被捕获。
- Reserved keyword in attribute name——一个名称与保留字冲突。
- ExpressionAttributeValues invalid
- 学习：Update expressions · Expression names & values
参考资料
- Using update expressions in DynamoDB — Amazon DynamoDB Developer Guide
- TransactWriteItems — Amazon DynamoDB API Reference
- Expression attribute names (aliases) in DynamoDB — Amazon DynamoDB Developer Guide
最后核实于 2026-07-13，依据上方链接的 AWS 官方文档。