Windows 10系统使用Docker作为驱动启动Minikube失败求助

排查步骤 #

从报错日志可判断核心异常为：minikube调用docker version命令检测docker状态时超时，但手动执行docker命令正常，属于minikube调用链路或配置适配问题，按以下步骤逐一排查即可：

• 检查执行权限
  确认运行minikube命令的PowerShell/终端是以管理员权限启动的，Windows下非管理员权限运行可能被系统安全规则拦截docker服务调用，导致超时。
• 清理minikube旧残留配置
  日志中存在minikube配置文件读取失败的报错，可能是首次启动产生了异常缓存，执行以下命令清理所有残留：

  minikube delete --all --purge
  

• 校验Docker Desktop WSL2集成配置
  Windows下Docker Desktop默认使用WSL2作为运行后端，需确认两处配置：
  1. 打开Docker Desktop设置页的General标签，确认「Use the WSL 2 based engine」选项已开启
  2. 进入Resources->WSL Integration标签，确认你正在使用的WSL发行版集成开关已开启，若在Windows原生PowerShell运行minikube，还需要开启「Expose daemon on tcp://localhost:2375 without TLS」选项
• 调整启动参数绕过超时限制
  旧版本minikube默认docker健康检测超时时间较短，启动时可手动延长超时时间，适配Windows环境下的调用延迟：

  # 原生PowerShell运行执行该命令
  minikube start --driver=docker --docker-env DOCKER_HOST=tcp://127.0.0.1:2375 --wait-timeout=10m
  

  # WSL2终端运行执行该命令
  minikube start --driver=docker --wait-timeout=10m
  

• 版本适配处理
  你使用的minikube v1.19.0发布时间早于Docker 20.10.8，存在驱动适配兼容问题，如果以上步骤都无法解决，将minikube升级至v1.22.0及以上版本即可解决适配问题。

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