A timeout occured while waiting for a WSL integration agent to become ready

6 min read
A timeout occured while waiting for a WSL integration agent to become ready.This can occur when starting after an abrupt termination. To work around the issue, please terminate WSL (wsl --shutdown) and start Docker Desktop again. If the issue persists please collect diagnostics and submit an issue (https://docs.docker.com/desktop/troubleshoot/overview/#diagnose-from-the-terminal).Error details:1 error occurred:	* starting WSL integration service: synchronising agents: starting added distros: 1 error occurred:	* waiting for WSL integration for Ubuntu: waiting for WSL distro integration to become ready in "Ubuntu": timeout

这个错误通常表示Docker Desktop与WSL集成有问题，可能是由于WSL守护进程未正确启动或未能在合理的时间内启动。

尝试按照以下步骤解决此问题：

  1. 在Windows命令提示符中，运行以下命令关闭WSL：wsl --shutdown。
  2. 重新启动Docker Desktop并等待它完全启动。
  3. 如果问题仍然存在，请尝试更新Docker Desktop到最新版本，并检查WSL是否正确安装和配置。
  4. 如果仍然无法解决问题，请运行Docker Desktop的诊断工具，以查看是否存在其他问题。在Docker Desktop的设置中，选择“Troubleshoot”选项卡，然后单击“Diagnose & Feedback”按钮。等待诊断工具完成，并查看是否存在任何错误或建议。