# 构建上下文太大

**URL:** <https://buildx.do/t/%E6%9E%84%E5%BB%BA%E4%B8%8A%E4%B8%8B%E6%96%87%E5%A4%AA%E5%A4%A7/67>\
**Category:** 云栈探研\
**Tags:** 容器技术\
**Created:** [2026 年10 月 4 日 08:15 UTC](https://buildx.do/t/%E6%9E%84%E5%BB%BA%E4%B8%8A%E4%B8%8B%E6%96%87%E5%A4%AA%E5%A4%A7/67 "2026-10-04T08:15:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![sunkeqi](https://buildx.do/letter_avatar_proxy/v4/letter/s/e8c25b/32.png) [@sunkeqi](https://buildx.do/u/sunkeqi)\
**Post date:** [2026 年10 月 4 日 08:15 UTC](https://buildx.do/t/%E6%9E%84%E5%BB%BA%E4%B8%8A%E4%B8%8B%E6%96%87%E5%A4%AA%E5%A4%A7/67/1 "2026-10-04T08:15:00Z")

</div>

「构建上下文太大」。

把整个仓库都传进去了。忽略掉依赖目录和日志。每次构建省下来的时间很明显。

这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。

镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康检查只用镜像里存在的命令。重启策略和数据卷一起看，机器重启后服务还在，才算配完。

记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。

复查「构建上下文太大」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。镜像和运行分开看。构建阶段清掉安装缓存，最终镜像不带编译工具，不用 root。运行阶段写明对外端口、数据卷、重启策略。挂载进去是空的，就把两边路径都打印出来，多半是多了一层目录。健康检查只用镜像里真有的命令，命令不存在会一直失败，看起来像应用没就绪。基础镜像版本写死，避免本地有的库在服务器上没有。两个容器不能互相等对方先启动，把真正的依赖写出来，另一个改成可以稍后连接。机器重启后服务还在、数据还在，这份配置才算完。

操作顺序。1. 写明基础镜像的版本，不写 latest。2. 构建末尾清掉安装缓存，最终阶段不带编译工具。3. 进程不用 root，缺目录就补权限。4. 启动时打印对外端口、挂载路径和实际读到的环境变量名。5. 健康检查改成镜像里存在的命令。6. 写上重启策略，重启机器后确认进程和数据都还在。7. 两个容器若互相等待，改成一个可稍后连接。路径或端口看反，会表现为空目录或连不上，先核对打印出来的值。

---

<div class="post-metadata">

**Author:** ![dengyi](https://buildx.do/letter_avatar_proxy/v4/letter/d/b5e925/32.png) [@dengyi](https://buildx.do/u/dengyi)\
**Post date:** [2026 年10 月 4 日 09:12 UTC](https://buildx.do/t/%E6%9E%84%E5%BB%BA%E4%B8%8A%E4%B8%8B%E6%96%87%E5%A4%AA%E5%A4%A7/67/2 "2026-10-04T09:12:00Z")

</div>

构建上下文忽略依赖目录和日志。每次少传很多，构建会快一截。
