---
url: /zh/build/login-debug.md
description: |
  介绍如何在流水线构建过程中或构建结束后登录 Docker 容器进行调试， 解决本地与 CI 环境不一致的问题。
---
## 何时需要登录调试？

用户脚本在 Docker 容器内执行，本地与 CI 环境可能不一致，
导致本地正常但 CI 构建失败。
此时可在日志页面点击「登录调试」登入容器排查问题。

## 如何使用？

流水线执行时启动 Docker 容器运行用户脚本，
构建结束后默认销毁容器，需在构建环境存活期间完成调试。

以下两种情况可登录调试：

1. **构建过程中**：直接点击「登录调试」
2. **构建结束后**：在日志页面勾选 `Debug` 选项（位于 `Rebuild` 旁），然后点击 `Rebuild`。
   新触发的构建结束后环境保留 5 分钟供调试。

* **定时检测**：系统定时检测登录状态——无人登录则自动销毁，有人登录则继续保留，最长 1 小时。

## 调试技巧

点击 `Rebuild` 时可选择需要执行的 Pipeline、Stage、Job，便于复现问题环境。

例如，构建在 `install` 阶段失败，怀疑是依赖安装命令与本地行为不一致，
可只勾选该 Stage 重新执行，再通过「登录调试」进入容器核对产物
（如 `node_modules`）是否与本地一致。

> 提示：
>
> * 选择 Pipeline、Stage、Job 后，未选中的任务不会执行，
>   适合快速定位失败发生在哪个环节；
> * 若所选 Stage 依赖前置任务（如产物、依赖等），请按需将前置任务一起勾选，
>   否则重跑时可能因缺少前置产物而失败。