目录

HTTP分片上传报错问题定位

问题现象

通过http.MultiFormData[]上传失败,错误信息:

{"timestamp":1747124996117,"status":400,"error":"Bad Request","exception":"org.springframework.web.multipart.support.MissingServletRequestPartException","message":"Required request part 'chunk' is not present","path":"/upload/clip"}

定位过程

这是传参错误导致,错误示例如下:

uploadFile1(filePath: string) {
    let httpRequest = http.createHttp();
    let requestMultipart: http.MultiFormData[] = [];
    let formData: http.MultiFormData = {
      name: 'xxx.mp4',
      contentType: 'video/mp4',
      filePath: filePath,
      remoteFileName: 'xxx.mp4',
      data: {
        'vid': 'xxx',
        'fseq': 'xxx',
        'cmd5': 'xxx',
        'chunk': ''
      }
    };
    requestMultipart.push(formData);
    httpRequest.request(
      this.uploadUrl,
      {
        method: http.RequestMethod.POST,
        header: {
          'Content-Type': 'multipart/form-data',
          'APPID': 'xxx',
          'TOKEN': 'xxx',
          'VERSION': 'xxx',
        },
        multiFormDataList: requestMultipart,
      }, (err: BusinessError, data: http.HttpResponse) => {
      if (err) {
        console.error(`Failed to uploadFile. Code: ${err.code}, message: ${err.message}`);
        return;
      }
      console.info(`Succeeded to uploadFile:  ${data}`);
    });
  }

应把data数据放到requestMultipart中。

分析结论

数据结构不对导致服务器无法捕获引起错误,修改传参可解决处理。

修改建议

通过对象requestMultipart上传时需要把data数据拎出来单独push到requestMultipart对象里面才能收到,代码示例如下:

import { http } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  private uploadUrl: string = 'http://127.0.0.1:9588/'; //替换为实际服务器URL。

  uploadFile(filePath: string) {
    let httpRequest = http.createHttp();
    let requestMultipart: http.MultiFormData[] = [];
    let formData: http.MultiFormData = {
      name: 'share.txt', //数据名称。
      contentType: 'text/plain', //数据类型,自API 11开始支持该属性。
      filePath: filePath, //替换为实际文件路径。
      remoteFileName: 'share.txt', //上传到服务器保存为文件的名称。
    };
    requestMultipart.push(formData);

    httpRequest.request(
      this.uploadUrl,
      {
        method: http.RequestMethod.POST,
        header: {
          'Content-Type': 'multipart/form-data',
        },
        multiFormDataList: requestMultipart,
      }, (err: BusinessError, data: http.HttpResponse) => {
      if (err) {
        console.error(`Failed to uploadFile. Code: ${err.code}, message: ${err.message}`);
        return;
      }
      console.info(`Succeeded to uploadFile:  ${data.result}`);
    });
  }

  build() {
    Column({ space: 10 }) {
      Button('MultiFormData分片上传').onClick(() => {
        let context = this.getUIContext()?.getHostContext();
        if (!context) {
          return;
        }
        let filePath = context.filesDir + '/' + 'share.txt'; //文件沙箱路径,使用时替换实际文件路径。
        this.uploadFile(filePath);
      });
    }
    .height('100%')
    .width('100%');
  }
}