Docker Stack Deploy未部署代码变更后构建镜像的问题求助

哇，这个问题我之前帮好几个开发者排查过，咱们一步一步来捋可能的坑：

1. 镜像标签复用导致拉取旧镜像 #

很多时候大家习惯用latest标签或者固定自定义标签（比如v1）构建镜像。如果部署环境的容器编排工具（Docker Compose、K8s等）发现本地已有该标签的镜像，就不会主动拉取新构建的版本，直接复用旧镜像运行。

• 排查方法：登录部署服务器，执行docker images查看对应镜像的创建时间，确认是否和最新构建时间匹配。
• 解决方法：
  • 每次构建用唯一标签，比如基于Git短提交哈希（git rev-parse --short HEAD）、时间戳（date +%Y%m%d%H%M%S）生成标签，确保每次构建的标签都不重复。
  • 若坚持用固定标签，部署时强制拉取镜像：Docker Compose加--pull always参数，K8s中设置imagePullPolicy: Always。

2. 构建上下文或.dockerignore的问题 #

你以为工作区拉取了最新代码，但构建时根本没把变更文件打包进镜像！常见场景：

• .dockerignore不小心排除了变更的目录/文件（比如误把src/、dist/这类核心目录加入忽略列表）。
• 构建命令指定的上下文路径错误，比如你在项目根目录，但构建时用了子目录作为上下文，导致新代码没被纳入构建范围。
• 排查方法：
  • 检查.dockerignore内容，确认修改的文件没被意外忽略。
  • 临时在Dockerfile中加一行RUN ls -la /path/to/your/app，构建后进入镜像查看文件是否为最新版本。
• 解决方法：修正.dockerignore确保必要文件被包含；确认构建命令的上下文路径是正确的项目根目录。

3. 前端应用的浏览器缓存（前端项目专属） #

即使镜像里的代码是新的，浏览器可能还缓存了旧的静态资源（JS、CSS、图片等），导致看不到变更。

• 排查方法：打开浏览器开发者工具（F12），在Network标签勾选「Disable cache」后刷新页面，或用隐私模式打开页面测试。
• 解决方法：
  • 给静态资源加内容哈希，比如在Webpack、Vite等构建工具中开启文件名哈希，生成app.abc123.js这类带唯一标识的文件，让浏览器主动加载新资源。
  • 在服务器配置中给静态资源设置合理缓存策略：非哈希文件设短缓存，哈希文件设长缓存。

4. 部署流程的衔接问题 #

构建任务成功了，但部署步骤没用到新构建的镜像：

• 构建完成后没把镜像推送到镜像仓库，部署时仍拉取仓库里的旧版本。
• 部署脚本硬编码了旧镜像标签，没有动态替换为新构建的标签。
• 排查方法：
  • 检查镜像仓库中对应标签的镜像，确认是否有最新版本。
  • 查看部署脚本日志，确认拉取的镜像标签和构建的是否一致。
• 解决方法：确保构建完成后自动推送镜像到仓库；部署脚本动态获取最新镜像标签（比如从构建任务输出中提取commit哈希）。

5. 多环境配置不匹配 #

你修改的是开发环境配置，但部署的是生产环境，或者配置文件没被正确替换：

• 修改了.env.development，但部署时用的是.env.production，生产环境配置未更新。
• 构建时环境变量设置错误，导致应用加载的还是旧配置或资源。
• 排查方法：进入运行的容器内部，查看应用配置文件内容，或查看应用日志确认加载的环境配置。
• 解决方法：确认构建和部署使用的是正确环境的配置；构建过程中正确注入环境变量。

内容的提问来源于stack exchange，提问作者Tara Prasad Gurung