使用Microsoft Graph REST API处理Excel并发编辑与单元格锁定

1. 用ETag实现乐观锁（推荐轻量级方案） #

这是Microsoft Graph Excel API原生支持的并发控制方式，完全不需要额外的锁定逻辑：

• 每次通过Graph获取单元格/范围数据时，响应头里会返回ETag字段，代表当前数据的版本标识。
• 当你要更新数据时，把获取到的ETag值放到请求头的If-Match字段里发送给服务器。
• 如果服务器端数据的版本和你发送的ETag不一致，会返回412 Precondition Failed状态码，说明这段时间已经有其他用户修改过数据。这时你可以提示用户重新获取最新数据，或者提供合并界面处理冲突。

示例流程：

1. 获取单元格数据：GET /me/drive/items/{itemId}/workbook/worksheets/{sheetId}/range(address='A1')
   响应头包含ETag: W/"{version}"
2. 尝试更新：PATCH /me/drive/items/{itemId}/workbook/worksheets/{sheetId}/range(address='A1')
   请求头添加If-Match: W/"{version}"
   • 如果ETag匹配，更新成功；
   • 如果不匹配，返回412，触发冲突处理逻辑。

这种方式尤其适合主键字段这类关键数据的更新，既能避免覆盖，又不需要维护复杂的锁定状态。

2. 单元格/范围级锁定（强制权限控制） #

如果要从根源上防止并发编辑特定区域，可以通过Graph API设置Excel工作表的保护规则，锁定指定单元格，只允许特定用户编辑：

• 首先启用工作表保护：

  POST /me/drive/items/{itemId}/workbook/worksheets/{sheetId}/protection/protect
  Content-Type: application/json
  {
    "allowEditRanges": true,
    "password": "可选密码"
  }
  

• 然后添加允许编辑的范围，并指定授权用户：

  POST /me/drive/items/{itemId}/workbook/worksheets/{sheetId}/protection/allowedRanges/add
  Content-Type: application/json
  {
    "address": "A1:A10",
    "users": ["{userId1}", "{userId2}"]
  }
  

未被添加到允许列表的用户，无法编辑指定范围的单元格，直接从权限层面阻断并发冲突。

3. 批量事务操作保证原子性 #

对于需要多步更新的操作（比如同时修改主键和关联字段），可以用Graph的批量请求功能，把多个更新操作打包成一个事务：

• 所有操作要么全部成功，要么全部失败，避免部分更新导致的数据不一致。
• 批量请求格式示例：

  POST /$batch
  Content-Type: application/json
  {
    "requests": [
      {
        "id": "1",
        "method": "PATCH",
        "url": "/me/drive/items/{itemId}/workbook/worksheets/{sheetId}/range(address='A1')",
        "headers": { "If-Match": "W/{version1}" },
        "body": { "values": [["new-primary-key"]] }
      },
      {
        "id": "2",
        "method": "PATCH",
        "url": "/me/drive/items/{itemId}/workbook/worksheets/{sheetId}/range(address='B1')",
        "headers": { "If-Match": "W/{version2}" },
        "body": { "values": [["related-data"]] }
      }
    ]
  }
  

为什么不推荐自定义双重锁定 #

自定义双重锁需要维护额外的锁定状态（比如分布式锁服务），不仅增加复杂度，还可能出现锁过期、释放失败等问题。而上面的三种方案都是利用Microsoft Graph和Excel本身的原生能力，更稳定且易于维护。

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