如何构造PUT请求修改JSON数组嵌套元素且不覆盖其余原有字段

你遇到的字段被清空问题，核心是HTTP PUT 方法的原生语义是全量替换目标资源：服务端收到PUT请求后，会把请求路径对应的资源，直接替换成你请求体里传入的完整内容，不会自动保留你没传的字段。
你之前修改顶层name、id字段时没有出现其他字段丢失的情况，本质是当时的请求体携带了所有顶层字段的取值，仍然是全量替换，并非接口支持顶层局部更新、嵌套字段不支持。你这次只传了pets[].stats.color的取值，服务端自然会把整个pets数组的对应元素替换成你传入的、仅包含stats字段的对象，name、age等未传字段就会被清空。

方案1：先拉取全量资源，本地修改后全量回传（通用性最高，无API依赖） #

这是所有RESTful API都兼容的方案，不需要接口做特殊支持，步骤如下：

• 先发起GET请求拉取当前资源的完整JSON结构
• 在本地代码中定位到要修改的目标字段（即对应宠物条目下的stats.color），将值改为red，其余所有字段原封不动保留
• 把修改后的完整JSON作为请求体，发起PUT请求完成更新
  参考实现代码：

import requests

# 拉取资源最新完整数据
get_resp = requests.get(url, headers=headers)
full_resource = get_resp.json()

# 修改目标字段：如果pets数组有多个元素，不要硬编码索引0，要通过宠物唯一标识（如name、id）匹配到目标条目再修改
full_resource["pets"][0]["stats"]["color"] = "red"

# 全量回传更新
put_resp = requests.put(url, json=full_resource, headers=headers)

风险提示：如果从GET拉取数据到PUT回传的间隔中，有其他请求修改了同一份资源，这个方案会覆盖掉其他更新。如果业务对数据一致性要求高，可以搭配接口的版本号/乐观锁机制使用。

方案2：使用接口支持的局部更新能力（无需拉取全量，性能更好） #

大部分成熟的API都会提供局部更新能力，不需要每次修改都传全量数据：

• 优先确认接口是否支持PATCH方法：PATCH的原生语义就是局部更新资源，常见的实现包括JSON Patch标准，你可以直接指定要修改的字段路径，不需要传其他字段。符合JSON Patch标准的请求示例：

# 直接指定修改pets数组第1个元素下stats.color的值为red
patch_payload = [
    {"op": "replace", "path": "/pets/0/stats/color", "value": "red"}
]
patch_resp = requests.patch(url, json=patch_payload, headers=headers)

• 部分API会对PUT方法做自定义扩展，支持用字段路径作为key传参实现局部更新，比如请求体可以写成{"pets[0][stats][color]": "red"}，但这类实现没有统一标准，必须以对应接口的官方文档说明为准，不要盲目使用。

方案3：调用子资源独立更新接口 #

如果pets数组下的每个宠物是独立子资源，大部分API会暴露子资源的独立操作路径，不需要修改整个顶层用户资源，比如更新宠物信息的路径可能是/users/20304/pets/{pet_id}，直接调用这个接口修改对应宠物的stats.color即可，不会影响其他字段。

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