一、问题描述

我们在安装 Qt 的时候，会不会经常出现以下问题？就是下载着下载着就会出现 无法下载存档 http://download.qt.io/online/xxxxx replied: Internal Server Error 的错误。

图 1.1 Qt 报错“无法下载存档”

这通常都是因为网络原因导致无法下载对应的文件造成的，这个和 Qt 官方下载源的网络连接有关，国内下载出现该问题是很正常的。

二、解决方法

2.1 更换 Qt 下载源

对于这些问题，通常的解决办法就是更换 Qt 的下载源。

根据命令 MaintenanceTool.exe --help 提供的帮助手册，我们可以找打这样一个参数 --mirror <mirror>。

图 2.1.1

所以，我们只需要在控制台输入命令 MaintenanceTool.exe --mirror https://mirrors.cloud.tencent.com/qt/ 就可以以腾讯的 Qt 镜像源打开 Qt Maintenance Tool。更换为国内的下载源之后，不仅可以解决错误，还可以极大地加快下载速度。

但是每次都要这样打开属实有点麻烦，所以大家可以按照我的方法操作一遍即可做到一劳永逸：

  1. 找到 Qt Maintenance Tool 的快捷方式。
    图 2.1.2 打开快捷方式所在位置
  2. 右键快捷方式，打开属性面板。
    图 2.1.3 打开属性面板
  3. 然后在目标栏的最后追加新参数 --mirror https://mirrors.cloud.tencent.com/qt/（注意最前面有个空格，要以空格隔开参数）。
    图 2.1.4 完成后的设置
  4. 应用修改并确定。

这样修改完成后，每次使用该快捷方式就可以以其他镜像源的方式打开 Qt Maintenance Tool 了😘。

2.2 可选镜像源

这里我比较推荐 Tencent 和 Aliyun 的镜像源，相对而言这两个更加安全稳定，使用起来更加舒心。当然，你还可以选择其他的镜像源，下面是一些常见的 Qt 国内下载镜像源。

描述镜像源地址
Tencenthttps://mirrors.cloud.tencent.com/qt/
Aliyunhttps://mirrors.aliyun.com/qt/
清华大学https://mirrors.tuna.tsinghua.edu.cn/qt/
北京理工大学http://mirror.bit.edu.cn/qtproject/
中国互联网络信息中心http://mirror.bit.edu.cn/qtproject/

2.3 情况本地缓存

如果配置完成后还有问题，可以尝试清空一下缓存，再重新打开 Qt Maintenance Tool 试试：

图 2.3.1 清空缓存