UniApp下载文件如何判断下载失败-uni-app-PHP中文网

UniApp下载文件如何判断下载失败

夜晨

发布： 2025-01-14 16:21:05

原创

1094人浏览过

判断 UniApp 下载文件失败的方法：检查网络状态：网络中断、服务器故障等原因会使请求失败。校验服务器状态码：404 等错误码表示文件不存在或出现其他错误。检测下载中断：网络中断会导致文件下载不完整。验证文件完整性：对比文件大小或计算 MD5 值与预期值，确保文件无损坏。

UniApp下载文件如何判断下载失败

UniApp下载文件如何判断下载失败？这可不是件容易的事儿！

很多开发者在UniApp里下载文件时，都遇到过下载失败却无法及时感知的窘境。这篇文章就来深入探讨这个问题，帮你彻底解决这个让人头疼的难题。读完之后，你不仅能写出健壮的下载代码，还能对UniApp的下载机制有更深刻的理解，甚至能举一反三，应对更多棘手的网络请求问题。

基础知识铺垫：UniApp下载的本质

UniApp的下载功能，本质上是通过网络请求（通常是uni.request或uni.downloadFile）来实现的。所以，判断下载失败，其实就是判断网络请求是否成功。但事情没那么简单，网络请求的成功，并不一定意味着文件下载的成功。

核心概念：下载失败的多种可能性

下载失败，可能由多种原因导致：

网络问题: 网络中断、服务器故障、DNS解析失败等等，这些都会导致请求失败。
服务器返回错误: 服务器可能返回一个错误码（比如404 Not Found），表示文件不存在或其他错误。
下载中断: 下载过程中网络中断，导致文件下载不完整。
文件损坏: 下载的文件可能在传输过程中损坏，导致无法正常使用。

UniApp下载的实现和关键代码

我们主要用uni.downloadFile来下载文件，它会返回一个downloadTask对象，这个对象包含了下载状态信息。

<code class="javascript">uni.downloadFile({
  url: '你的下载链接',
  filePath: uni.env.USER_DATA_PATH + '/download.txt', // 文件保存路径
  success: function (res) {
    console.log('下载成功', res.tempFilePath);
    // 下载成功后处理，例如打开文件
  },
  fail: function (err) {
    console.error('下载失败', err);
    // 下载失败处理，例如提示用户
  },
  complete: function () {
    console.log('下载完成'); // 无论成功或失败都会执行
  }
})</code>

登录后复制

代码详解与进阶

文小言

百度旗下新搜索智能助手，有问题，问小言。

查看详情

这段代码看起来简单，但里面藏着不少玄机。

success回调函数只表示请求成功，并不代表文件完整无缺。fail回调函数能捕捉到一些明显的错误，但并不能涵盖所有情况。

那么，如何更可靠地判断下载失败呢？

检查statusCode: res对象中包含statusCode属性，它表示服务器返回的状态码。200表示成功，其他值则表示失败。我们需要根据不同的状态码进行不同的处理。
校验文件大小: 下载完成后，可以检查文件的实际大小是否与预期大小一致。如果不一致，则可能文件下载不完整或损坏。
MD5校验: 下载完成后，可以计算文件的MD5值，并与服务器提供的MD5值进行比较。如果不同，则表示文件损坏。

更健壮的代码示例

<code class="javascript">uni.downloadFile({
  url: '你的下载链接',
  filePath: uni.env.USER_DATA_PATH + '/download.txt',
  success: (res) => {
    // 获取文件大小
    uni.getFileInfo({
      filePath: res.tempFilePath,
      success: (fileInfo) => {
        //  此处可以加入MD5校验，更可靠
        if (fileInfo.size === 预期文件大小) {
          console.log('下载成功且完整');
        } else {
          console.error('下载文件大小不符，可能下载不完整或文件损坏');
          // 删除不完整的文件
          uni.removeSavedFile({filePath: res.tempFilePath});
        }
      },
      fail: (err) => {
        console.error('获取文件信息失败', err);
      }
    });
  },
  fail: (err) => {
    console.error('下载失败', err);
  },
  complete: () => {
    console.log('下载完成');
  }
});
</code>

登录后复制

性能优化与最佳实践