如何轻松解决uniapp开发支付宝/钉钉小程序uni.uploadFile报错

2023-06-18 22:11:28

为什么使用 Uni.uploadFile 时会遇到“无效参数”错误

当你在使用 Uni.uploadFile 上传文件到支付宝或钉钉小程序时，可能会遇到“uploadFile:fail 无效参数”错误。这通常是由于以下原因造成的：

1. 文件大小限制

支付宝小程序对上传文件的大小限制为 10MB，而钉钉小程序为 20MB。如果你上传的文件超过了这个限制，就会触发这个错误。

代码示例：

const filePath = 'my-file.png';

uni.uploadFile({
  url: 'https://example.com/upload',
  filePath: filePath,
  success: (res) => {
    console.log('文件上传成功');
  },
  fail: (err) => {
    if (err.errMsg === 'uploadFile:fail 无效参数') {
      console.log('文件大小超过限制');
    }
  }
});

2. 文件类型限制

支付宝小程序和钉钉小程序只支持上传特定类型的文件。支付宝小程序支持的文件类型包括图片、视频、音频和文档，而钉钉小程序还支持压缩包。如果你尝试上传其他类型的文件，也会导致这个错误。

代码示例：

const filePath = 'my-file.exe';

uni.uploadFile({
  url: 'https://example.com/upload',
  filePath: filePath,
  success: (res) => {
    console.log('文件上传成功');
  },
  fail: (err) => {
    if (err.errMsg === 'uploadFile:fail 无效参数') {
      console.log('不支持的文件类型');
    }
  }
});

3. 文件路径错误

在调用 Uni.uploadFile 时，你需要指定要上传的文件的路径。如果你指定的路径不正确，就会导致这个错误。

代码示例：

const filePath = 'not-a-real-path.png';

uni.uploadFile({
  url: 'https://example.com/upload',
  filePath: filePath,
  success: (res) => {
    console.log('文件上传成功');
  },
  fail: (err) => {
    if (err.errMsg === 'uploadFile:fail 无效参数') {
      console.log('文件路径错误');
    }
  }
});

4. 服务器端配置错误

如果你的服务器端没有正确配置接收文件，也会导致这个错误。

代码示例：

const filePath = 'my-file.png';

uni.uploadFile({
  url: 'https://example.com/upload',
  filePath: filePath,
  success: (res) => {
    console.log('文件上传成功');
  },
  fail: (err) => {
    if (err.errMsg === 'uploadFile:fail 无效参数') {
      console.log('服务器端配置错误');
    }
  }
});