求助：更新SharePoint Online ListItem未实现版本不递增的排查

问题原因分析 #

• bNewDocumentUpdate参数不对症：这个参数是给文档库设计的，用于覆盖文档内容时不生成新版本，对列表项的字段更新完全无效。列表项的版本控制逻辑和文档库不同，设置这个参数起不到任何作用。
• 修改了触发版本的敏感字段：你更新了Modified_x0020_By、Editor这些系统自带字段，SharePoint对这类字段的修改默认会强制触发版本递增，哪怕用validateUpdateListItem也绕不开。另外，Approval_x0020_status作为审批状态字段，如果列表开启了内容审批，状态变更本身也会触发版本递增。

可行解决方案 #

1. 用正确的REST方法实现无版本更新 #

针对列表项，需使用MERGE请求结合KeepItemVersion参数才能跳过版本递增：

• 请求地址：/_api/web/lists('ea99ccea-d626-4a60-bfcb-d3cd43705cc8')/Items(27)
• 请求方式：POST，同时设置请求头X-HTTP-Method: MERGE
• 必备请求头：
  • Content-Type: application/json;odata=verbose
  • X-RequestDigest: [你的请求摘要值]
• 请求体示例：

{
  "__metadata": { "type": "SP.Data.[列表内部名称]ListItem" },
  "Approval_x0020_status": "Approved",
  "Approver_x0020_comments": "",
  "KeepItemVersion": true
}

提示：[列表内部名称]要替换为你列表的实际内部名称，可通过调用/_api/web/lists('ea99ccea-d626-4a60-bfcb-d3cd43705cc8')查询获取。

2. 避免修改系统内置字段 #

尽量不要手动修改Modified_x0020_By、Editor这类字段，SharePoint会自动维护它们的值。如果必须修改，这类操作基本都会触发版本递增，没有常规方法可以跳过。

3. 检查列表版本配置 #

进入列表的版本设置页面，确认是否开启了“对每个主要版本要求签出”或其他强制生成版本的选项，这些配置会覆盖你的参数设置，导致版本仍会递增。

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