使用Seequent Evo File API上传文件出现Bad Request错误如何解决

生成预签名链接阶段错误 #

• 生成上传链接的请求缺少file_name、file_size、content_type等必填参数，或参数格式不符合要求，比如file_size超出API单文件大小上限、content_type格式非法
• 生成链接时的鉴权凭证无效，包括X-Api-Key过期、Bearer令牌权限不足，导致生成的上传链接本身无效
• 生成链接时提交的file_size与实际文件大小差异过大，后续上传时校验不通过

上传请求配置错误 #

• HTTP请求方法不匹配，预签名上传链接仅支持PUT方法，使用POST/GET方法会直接返回400
• 请求头配置不符合要求：
  • 未携带Content-Type头，或携带的MIME类型与生成链接时提交的content_type参数不一致
  • 额外添加了预签名逻辑未覆盖的自定义请求头，导致签名校验失败
  • Content-Length参数设置错误，和实际上传的文件二进制大小不匹配
• 预签名链接超出有效时长，默认有效时长通常为15~30分钟，生成后长时间未使用会失效

文件与网络问题 #

• 上传的文件为空，或读取的二进制流存在损坏、不完整的情况
• 本地网络代理、防火墙自动修改了上传请求的头信息或请求体内容，导致签名校验不通过
• 开启了请求分片上传，但当前预签名链接不支持分片传输，导致单段请求内容不符合校验规则

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