Win10家庭版Django项目Docker Compose启动多容器遇凭证获取错误

问题场景 #

在Windows 10 Home系统中使用Docker Desktop开发Django项目，执行docker compose up -d（或docker-compose up -d）命令创建多容器时，出现以下错误：

$ docker compose up -d
[+] Running 0/1
mysql Pulling
error getting credentials - err: exec: "docker-credential-desktop": executable file not found in %PATH%, out:

已尝试的无效操作 #

• 修改环境变量PATH，将原路径C:\Program Files\Docker\Docker\resources\bin改为C:\Program Files\Docker\Docker\resources\ bin\docker.exe或C:\Program Files\Docker\Docker\resources\bin\docker-compose.exe后，出现新错误：

  $ docker compose up -d
  bash:docker:command not found
  

• 修改config-options.json文件中的"credsStore"为"credStore"，无效果。

可行解决方案 #

1. 恢复并修正环境变量PATH配置 #

• 打开系统环境变量设置，将Docker相关路径恢复为C:\Program Files\Docker\Docker\resources\bin，同时新增C:\Program Files\Docker\Docker到PATH中（docker-credential-desktop.exe实际存放在这个目录下）。
• 关闭所有正在运行的终端（Git Bash、CMD、PowerShell等），重新打开后再执行命令，确保新的环境变量生效。

2. 调整Docker凭证存储配置 #

• 找到Docker用户配置文件config.json，路径为C:\Users\<你的用户名>\.docker\config.json（替换<你的用户名>为实际系统用户名）。
• 打开文件后，检查是否存在"credsStore": "desktop"字段：
  • 如果存在，将其修改为"credsStore": "wincred"（使用Windows原生凭证存储）；
  • 或者直接删除该字段，让Docker不依赖外部凭证存储工具。
• 保存文件后，重启Docker Desktop。

3. 重置Docker Desktop到出厂设置 #

• 打开Docker Desktop，点击右上角的齿轮图标进入设置页面，切换到Reset标签页。
• 点击Reset to factory defaults按钮，等待重置完成。
• 重置后重新配置Docker（如镜像加速源等），再尝试执行docker compose up -d命令。

注意事项 #

• 环境变量PATH只需指向包含可执行文件的目录，不需要直接指向.exe文件，否则会导致docker命令无法被终端识别。
• 修改环境变量后必须重启终端，否则新的路径配置不会生效。

内容的提问来源于stack exchange，提问作者daniel