.NET 9 Aspire启动报错Aspire.Hosting.Dcp.error[0]求助

问题说明 #

启动任意Aspire项目（包括StarterTemplate）时触发以下错误：

Aspire.Hosting.Dcp.the program finished with an error[0]
{"ExitCode": 1, "error": "could not determine installed DCP extensions: CreateFile C:\Users%username%.dcp\ext: The system cannot find the file specified."}

解决方案 #

• 手动创建缺失的DCP扩展目录
  打开文件资源管理器，定位到C:\Users\<你的用户名>\.dcp路径：

  1. 若.dcp目录不存在，先创建该目录
  2. 在.dcp目录下创建ext子目录

• 重置Aspire DCP环境
  打开PowerShell或命令提示符，执行命令清理Aspire缓存状态：

  dotnet aspire clean
  

  完成后重新启动Aspire项目。

• 匹配.NET 9与Aspire SDK版本
  检查全局安装的Aspire SDK版本是否与.NET 9兼容：

  dotnet tool list --global
  

  若版本不匹配，卸载旧版本并安装适配.NET 9的Aspire SDK：

  dotnet tool uninstall --global Microsoft.DotNet.Aspire.SDK
  dotnet tool install --global Microsoft.DotNet.Aspire.SDK --version 9.0.0-preview.4.24267.6 # 替换为对应.NET 9的预览/正式版本号
  

• 验证Docker Desktop配置

  1. 确认Docker Desktop服务正在运行
  2. 若使用WSL 2后端，检查Docker Desktop设置中资源 > WSL集成是否启用了当前使用的WSL发行版

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