Design Automation PUT请求Content-Range头缺失或格式异常问题排查

• 确认上传URL的合法性
  SharePoint的大文件上传必须先通过创建上传会话接口获取专用的uploadURL，不能直接使用普通文件路径。你需要先发送POST请求到/drives/{drive-id}/items/{parent-item-id}:/{filename}:/createUploadSession，用接口返回的uploadURL作为ossuploadURL的值，而非自行拼接的URL。

• 避免手动干预Content-Range头
  Design Automation会自动处理分块上传的Content-Range头，格式为bytes start-end/total（比如bytes 0-6291455/12582910），其中total必须是文件的准确总大小。不要在请求体的headers字段中手动添加Content-Range，否则会覆盖自动生成的合法头，导致格式错误。

• 检查请求体配置
  确保告知Design Automation上传信息的POST请求体中，输出项的配置没有干扰上传逻辑。正确的配置示例如下：

  {
    "outputs": [
      {
        "type": "application/octet-stream",
        "ossuploadURL": "你的SharePoint上传会话URL",
        "headers": {} // 此处留空，不要添加任何与Content-Range相关的配置
      }
    ]
  }
  

• 验证分块大小合规性
  SharePoint对分块上传的块大小有要求：最小5MB，最大60MB（最后一块可小于5MB）。如果Design Automation的分块大小超出这个范围，也会触发Content-Range相关错误。可以通过调整Design Automation的分块配置，或者在创建上传会话时指定maxChunkSize参数来匹配要求。

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