Docker部署.NET Core Web API时提示ASP.NET Core 5.0框架未找到如何解决

该报错的本质是容器运行环境内置的Microsoft.AspNetCore.App共享框架版本，和项目编译时依赖的5.0.0版本完全不匹配，无对应可用框架可供运行时加载。常见触发原因包括Dockerfile选择的基础镜像版本错配、项目目标框架与镜像版本不一致、本地Docker镜像缓存损坏。

• 第一优先级：修正Dockerfile的基础镜像版本匹配
  .NET 5.0版本的Web API项目，构建阶段和运行阶段必须严格使用对应大版本的官方镜像，严禁跨大版本混用镜像。正确的分层Dockerfile参考如下：

  # 构建阶段：使用匹配版本的SDK镜像完成项目编译
  FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
  WORKDIR /src
  COPY ["你的项目名.csproj", "./"]
  RUN dotnet restore
  COPY . .
  RUN dotnet publish -c Release -o /app/publish
  
  # 运行阶段：使用完全同版本的ASP.NET Core运行时镜像
  FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS runtime
  WORKDIR /app
  COPY --from=build /app/publish ./
  ENTRYPOINT ["dotnet", "你的项目名.dll"]
  

  常见错配场景：如果运行阶段选了aspnet:6.0/aspnet:8.0等高版本镜像，或者选了aspnet:3.1等低版本镜像，都会直接触发框架找不到的报错。
• 核对项目本身的目标框架配置
  打开项目根目录下的.csproj文件，检查<TargetFramework>节点的配置值，确认和Dockerfile里的镜像大版本完全对应：比如项目配置为net5.0，就必须搭配5.0版本的运行镜像。如果是项目框架版本调整后没同步更新Dockerfile，直接把镜像tag修改为匹配版本即可。
• 验证容器内的实际框架版本
  如果Dockerfile配置看似正确，可进入异常退出的容器实例，查看/usr/share/dotnet/shared/Microsoft.AspNetCore.App目录下的版本列表，确认是否存在5.0.0版本的框架文件夹。如果目录下没有对应版本，直接说明当前使用的运行镜像版本和项目依赖不匹配。
• 清理损坏的本地镜像缓存
  遇到镜像拉取不完整、tag对应错位导致的框架找不到问题，先手动拉取对应版本的干净运行镜像：

  docker pull mcr.microsoft.com/dotnet/aspnet:5.0
  

  重新构建镜像时关闭缓存层复用，避免旧缓存引发的版本错位：

  docker build --no-cache -t 你的自定义镜像名 .
  

• 生命周期适配注意事项
  .NET 5已结束官方支持周期，如果出现镜像拉取受限的情况，不要强行跨版本升级运行镜像，优先匹配和项目编译时一致的框架版本，避免运行时框架加载失败。

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