GitLab自托管环境中Flutter构建App Bundle流水线耗时过长的问题排查与优化咨询

看起来你的构建耗时差异确实离谱，结合你的配置和环境信息，我帮你梳理几个可能的原因和对应的优化方向：

一、核心瓶颈排查 #

首先建议你先查看流水线的详细日志，定位到底是哪个步骤拖慢了速度——是依赖下载、Gradle编译，还是镜像拉取？这能帮你精准解决问题。

1. 缓存未有效复用（最可能的原因） #

你的流水线只缓存了pub-cache，但Flutter构建Android App Bundle时Gradle的缓存完全没被处理，这是耗时的重灾区：

• 每次构建Gradle都会重新下载所有Android依赖、构建缓存完全失效，这会吃掉大量时间。
• 另外也要确认pub-cache的缓存是否真的命中了：看流水线日志里有没有「Restoring cache」的成功提示，如果每次都是「Creating cache」，说明缓存路径或权限有问题。

2. 磁盘IO性能差异 #

你的MacBook用的是高速SSD，但LXC容器的磁盘如果是HDD，读写速度会差好几倍——构建过程中大量的依赖下载、文件编译都会被磁盘速度拖慢。

3. 镜像拉取开销 #

如果你的Runner每次都要从ghcr.io重新拉取flutter:3.16.3镜像，这个过程会占用不少时间，尤其是网络不佳的时候。

4. 不必要的步骤 #

你在before_script里加了flutter doctor --android-licenses，但cirruslabs的Flutter镜像默认已经接受了Android许可证，这个步骤完全是多余的，每次运行都会增加不必要的耗时。

二、针对性优化建议 #

1. 补充Gradle缓存配置 #

修改你的.gitlab-ci.yml，添加Gradle缓存：

cache:
  paths:
    - $CI_PROJECT_DIR/.pub-cache/
    - $CI_PROJECT_DIR/.gradle/  # 新增Gradle缓存路径

build-android:
  before_script:
    - export PUB_CACHE=$CI_PROJECT_DIR/.pub-cache
    - export PATH="$PATH":"$PUB_CACHE/bin"
    - export GRADLE_USER_HOME=$CI_PROJECT_DIR/.gradle  # 指定Gradle缓存到项目目录
    - cd src
    # 移除不必要的flutter doctor --android-licenses

2. 确保Runner缓存镜像 #

在你的LXC Runner机器上手动拉取Flutter镜像，避免每次流水线都重新下载：

docker pull ghcr.io/cirruslabs/flutter:3.16.3

3. 启用并行构建加速 #

• 在Flutter构建命令中添加并行参数：

  flutter build appbundle --release --parallel
  

• 在项目的android/gradle.properties里添加Gradle优化配置：

  org.gradle.parallel=true
  org.gradle.caching=true
  org.gradle.daemon=true
  org.gradle.configureondemand=true
  

4. 检查Runner的Docker资源限制 #

虽然你的LXC有10核CPU，但Docker容器默认可能被限制了资源使用。可以在Runner的config.toml里添加资源配置：

[[runners]]
  # 其他配置不变
  [runners.docker]
    # 新增以下配置
    cpu_shares = 8192  # 分配更多CPU权重
    mem_limit = "12g"  # 限制内存为12G（根据你的16G RAM调整）

5. 验证磁盘性能 #

如果LXC用的是HDD，建议换成SSD；如果是SSD，可以在LXC里用dd命令测试读写速度，确认是否达到正常SSD水平：

# 测试写速度
dd if=/dev/zero of=test bs=1G count=1 oflag=direct
# 测试读速度
dd if=test of=/dev/null bs=1G count=1 iflag=direct

三、额外排查点 #

• 架构差异：你的Mac是ARM架构，Runner是x86架构，虽然理论上x86性能不会差太多，但可以确认cirruslabs的镜像是否为x86原生版本（是的话没问题）。
• GitLab缓存配置：确保Runner的/cache卷挂载正常，没有权限问题导致缓存无法写入。

备注：内容来源于stack exchange，提问作者Mohammad Mahdi