解决stable-diffusion-webui-docker构建时Git克隆失败问题

在使用stable-diffusion-webui-docker项目构建Stable Diffusion环境时，许多用户遇到了Git克隆失败的问题。本文将深入分析问题原因并提供多种解决方案。

问题现象

在构建过程中，当执行到克隆Stable Diffusion仓库的步骤时，会出现如下错误：

error: RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly: CANCEL (err 8)
error: 1915 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

根本原因分析

这个问题主要由以下几个因素导致：

1. 网络连接不稳定：Git在克隆大型仓库时对网络稳定性要求较高
2. 并行下载冲突：Docker构建过程中多个Git操作并行执行可能导致资源竞争
3. Git版本兼容性问题：旧版Git客户端可能存在某些已知缺陷
4. 系统资源限制：内存或缓存不足可能导致下载中断

解决方案汇总

方法一：升级Git基础镜像版本

修改/services/AUTOMATIC1111/Dockerfile文件，将第一行改为：

FROM alpine/git:2.43.0 as download

这个方案通过使用更新版本的Git客户端，解决了可能存在的兼容性问题。

方法二：添加下载延迟

在/services/AUTOMATIC1111/clone.sh脚本中的git init命令后添加：

sleep 180s

这个延迟确保了前一个下载操作有足够时间完成，避免了并行下载冲突。

方法三：预下载PyTorch镜像

在构建前手动拉取PyTorch基础镜像：

docker pull pytorch/pytorch:2.3.0-cuda12.1-cudnn8-runtime

这样可以避免在构建过程中同时下载大文件和执行Git操作导致的资源竞争。

方法四：完全清理后重建

1. 删除所有相关文件和Docker资源
2. 重新克隆项目仓库
3. 应用上述任一修改
4. 分步执行构建命令

最佳实践建议

1. 分步构建：先执行docker compose --profile download up --build，再执行docker compose --profile auto up --build

2. 环境检查：

   • 确保网络连接稳定
   • 检查系统资源是否充足
   • 验证Docker配置是否有足够内存分配

3. 日志分析：遇到问题时，仔细阅读错误日志，确定失败的具体阶段

4. 重试机制：对于偶发的网络问题，可以设置自动重试逻辑

技术原理深入

Git在HTTP/2协议下的数据传输对网络稳定性要求较高。当Docker构建过程中同时进行多个网络密集型操作时，容易导致TCP连接被意外终止。解决方案的核心思路是：

1. 降低并发度 - 通过延迟或顺序执行
2. 提高客户端兼容性 - 使用新版Git
3. 减轻系统负载 - 预下载大文件
4. 确保环境干净 - 避免残留文件干扰

这些方法从不同角度解决了网络资源竞争和系统资源不足的问题，用户可以根据自己的环境特点选择最适合的方案。