WSL2 中 Docker 登录报 The stub received bad data 如何解决？

2026-11-04数据小许

结论

错误出现在 Docker 保存凭据的环节。当前配置中的 "credsStore": "desktop.exe" 会让 Docker CLI 调用 docker-credential-desktop.exe，通过 Docker Desktop 的凭据助手处理登录信息。

如果配置不断被恢复，反复删除 credsStore 也解决不了问题。可以先用独立的 Docker 配置目录测试能否绕开该助手，再检查 WSL 调用 Windows 凭据助手的链路。仅凭这条错误，无法确定问题出在助手、Windows 凭据存储还是 WSL 集成，也不能认定密码错误或登录已经成功。

1. 检查实际使用的命令和配置

在 Ubuntu WSL2 中执行：

command -v docker
command -v docker-credential-desktop.exe
printf '%s\n' "${DOCKER_CONFIG:-$HOME/.docker}"

确认以下几点：

docker 是否来自预期的安装位置。
WSL 是否能找到 docker-credential-desktop.exe。
是否设置了 DOCKER_CONFIG，导致实际读取的配置目录与 ~/.docker 不同。

如果命令中使用了 --config，则以该参数指定的目录为准。检查实际使用的 config.json 时，也要查看是否存在针对当前 registry 的 credHelpers 配置；它会优先于全局 credsStore。

不要公开完整配置文件，其中可能包含认证信息。

2. 用独立配置目录尝试登录

下面的操作会创建一个临时配置目录，无须再修改被覆盖的 ~/.docker/config.json。先将示例 registry 和用户名替换成实际值：

REGISTRY='registry.example.com'
DOCKER_USER='your-user'
cfg_dir="$(mktemp -d)"
printf '%s\n' '{"auths": {}}' > "$cfg_dir/config.json"

docker --config "$cfg_dir" login "$REGISTRY" --username "$DOCKER_USER"

按提示输入密码或 registry 要求的 token。交互输入可以避免使用 -p 将密码直接写入命令行。

如果这次登录成功，问题可能与原配置及其选择的凭据助手有关。后续需要认证的命令也要指定同一目录，例如：

docker --config "$cfg_dir" pull "$REGISTRY/namespace/image:tag"

请替换示例镜像路径。不带 --config 执行命令，会重新使用默认配置。

使用这个方法时还需注意：Docker CLI 可能自动选择系统中可用的默认凭据助手，所以空配置不保证完全禁用所有助手；独立配置也不会继承原目录里的 context 等设置。如果出现新的助手错误或连接错误，应根据新报错继续定位。

3. 单独检查 Docker Desktop 凭据助手

如果 WSL 能找到该助手，可以执行：

docker-credential-desktop.exe list

如果命令本身也返回 The stub received bad data，说明脱离 registry 登录流程也能复现问题，应重点检查凭据助手及其 Windows 端依赖。如果能正常列出记录，也不能排除只有写入操作失败的情况。

输出可能包含 registry 地址和用户名，分享排查结果前需要脱敏。

也可以在 Windows PowerShell 中对同一个 registry 执行登录：

docker login registry.example.com --username your-user

如果 Windows 端成功、WSL 端失败，应优先检查 WSL 中的命令路径和 Windows 可执行程序调用情况；如果两端都失败，再重点排查 Docker Desktop 凭据助手及 Windows 端凭据存储。这两次测试只能帮助缩小范围，不能单独证明根因。

4. 恢复默认配置下的登录

根据前面的结果，检查 Docker Desktop 中目标 Ubuntu 发行版的 WSL 集成是否正常启用。保存工作后，重启 Docker Desktop 和 WSL，再测试默认配置下的 docker login。

如果需要执行以下命令，应在 Windows PowerShell 中运行：

wsl --shutdown

它会停止所有正在运行的 WSL 发行版，执行前应保存其中的工作。

如果凭据助手仍可独立复现错误，再考虑更新或修复 Docker Desktop 安装。原始信息没有提供版本和助手测试结果，不能断定某个版本一定能解决问题，也不宜直接删除整个 Windows 凭据库。

临时方案的凭据存储注意事项

当 Docker 没有使用凭据助手，回退到配置文件保存认证信息时，auth 通常采用 Base64 编码，并非加密。应将临时目录按敏感凭据处理，不要上传到代码仓库或作为日志附件。

使用结束后，可以针对该配置退出登录：

docker --config "$cfg_dir" logout "$REGISTRY"

独立配置适合临时恢复操作和定位故障；长期使用仍应恢复正常的凭据助手。