Docker安装失败:Docker Desktop installation failed

发布于:2025-07-06 ⋅ 阅读:(19) ⋅ 点赞:(0)

问题描述

安装过程中出现 “Docker Desktop installation failed. 值不能为 null。参数名: path” 错误提示

根本原因

1.获取日志(一般放在C:\Users\*****\AppData\Local\Docker)

根据你贴出的日志片段,Docker Desktop 安装失败的根本原因是:

System.ArgumentNullException: 值不能为 null。参数名: path
来自函数调用:System.IO.Path.GetFullPathInternal(String path)
发生位置:Docker.Installer.ExistingInstallation.FromRegistry(...)

根因分析:

Docker 安装器在读取注册表中上一次安装的卸载路径时,发现了一个 空值(null),从而导致 Path.GetFullPath() 函数崩溃。

换句话说:之前有一个 Docker 安装的残留信息还在注册表里,但路径为空或损坏,安装程序读取这个“无效路径”时直接崩了。

解决方案

方法一:使用注册表编辑器手动清理残留

1.按 Win + R,输入 regedit 回车,打开注册表编辑器

2.浏览到以下路径(可能存在多个):

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

  • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

  • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall

3.在这些路径下,逐个查找以下可能与 Docker 相关的子项(键):

  • 名称或 DisplayName 中包含 Docker, Docker Desktop 等。

  • 有些键值可能如下图(注册表项名称可能是 GUID 格式):

    {F36A3A84-...} DisplayName = Docker Desktop UninstallString = ...

4.找到后,如果其中的 InstallLocationUninstallString 是空的,直接右键删除整个项。

方法二:使用 PowerShell 清理注册表中空路径的 Docker 项(推荐)

以管理员身份运行 PowerShell,执行下面脚本:

# 要检查的注册表路径 $paths = @( "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall", "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall", "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall" ) foreach ($path in $paths) { Get-ChildItem $path | ForEach-Object { $displayName = ($_ | Get-ItemProperty).DisplayName if ($displayName -like "*Docker*") { $uninstallString = ($_ | Get-ItemProperty).UninstallString if ([string]::IsNullOrWhiteSpace($uninstallString)) { Write-Host "清理残留项:" $displayName Remove-Item $_.PsPath -Recurse -Force } } } }

执行后会自动删除注册表中带“Docker”但路径为空的项。