GitLab Artifacts上传速度异常缓慢的原因排查及解决方法咨询

碰到这种明明带宽充足，但GitLab artifacts上传慢到离谱的情况，确实挺闹心的。我结合自己排查这类问题的经验，给你梳理一套一步步来的排查和解决思路：

这是最常见的根源，先排除网络链路问题：

• 在你的Windows Runner机器上打开命令提示符，运行 ping gitlab.com 观察丢包率，如果丢包超过1%或者延迟波动极大，说明你的网络到GitLab服务器的链路不稳定，可能是运营商路由问题。可以试试切换DNS（比如改成8.8.8.8或1.1.1.1），或者如果允许的话，用代理/加速器测试上传速度。
• 直接测试到GitLab的上传速度：找个50MB左右的测试文件，用curl命令模拟上传（需要生成一个GitLab个人访问令牌）：

  curl -T test_file.bin "https://gitlab.com/api/v4/projects/[你的项目ID]/uploads" -H "PRIVATE-TOKEN: [你的令牌]" -w "%{speed_upload}"
  

  如果这个命令返回的上传速度远低于你的带宽，那基本可以确定是网络链路问题，不是Runner的锅。

不合理的配置也会拖慢上传：

• 看看你的.gitlab-ci.yml里的artifacts有没有设置压缩？默认是gzip，但如果你的待上传文件已经是压缩格式（比如zip、exe、rar），gzip不仅不会缩小体积，还会额外消耗CPU时间拖慢上传。可以尝试关闭压缩或者换成更高效的zstd（需要GitLab Runner版本>=14.0）：

  artifacts:
    paths:
      - path/to/your/artifacts/*
    compression: zstd  # 或者 compression: off
  

• 确认有没有设置不必要的artifacts:reports或者其他附加配置，这些可能会额外增加上传的处理时间。

有时候不是网络慢，是本地机器拖了后腿：

• 上传时打开任务管理器，看看CPU、内存和磁盘IO的使用率：如果CPU被占满，可能是杀毒软件在实时扫描待上传的文件，或者其他进程抢占资源。可以暂时关闭杀毒软件的实时防护，再测试上传速度。
• 如果待上传文件存在机械硬盘上，磁盘读取速度慢也会限制上传速率。可以临时把文件移到SSD上再试试上传。

日志能帮你定位具体的错误：

• Windows Runner的默认日志目录是C:\GitLab-Runner\logs，打开runner.log，搜索upload相关的日志，看看有没有重试、超时或者错误提示。比如反复出现retrying upload就说明网络连接不稳定，一直在重传。
• 开启Runner的debug模式排查：找到Runner的配置文件config.toml，把log_level改成debug，然后重启Runner服务，再跑一次CI任务，查看详细的上传日志，能找到更具体的问题点。

如果前面的步骤都没找到问题，可以绕过Runner的默认上传逻辑，手动用API上传：

• 在CI任务里添加手动上传的步骤（用CI内置的环境变量）：

  # 先打包文件（如果需要）
  7z a artifacts.zip path/to/your/artifacts/*
  # 用GitLab API上传
  curl -T artifacts.zip "https://gitlab.com/api/v4/projects/$CI_PROJECT_ID/jobs/$CI_JOB_ID/artifacts" -H "PRIVATE-TOKEN: $CI_JOB_TOKEN"
  

  如果手动上传速度正常，那说明是Runner的artifacts上传模块有问题，试试把Runner更新到最新版本，旧版本可能存在上传相关的bug。

偶尔官方GitLab的特定区域节点会出现性能波动：

• 可以查看GitLab官方的状态公告，确认你所在区域的上传服务是否正常。如果有故障，只能等待官方修复，或者尝试切换到其他地区的网络（比如用VPN）测试上传速度。

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