部署ASP.NET 5应用至GKE报未找到5.0.0版本框架错误如何解决？

1. 程序集入口名称不匹配：你创建的项目文件夹名为HellowWorldAspNet，dotnet new web默认生成的程序集dll名称为HellowWorldAspNet.dll，但两份Dockerfile的ENTRYPOINT配置都写为HellowWorldAspNetCore.dll，运行时找不到对应程序集时会触发误报框架缺失的错误，这是该类问题的高频诱因。
2. .NET 5已终止支持，基础镜像路径变更：微软已于2022年5月停止.NET 5的官方支持，原有mcr.microsoft.com/dotnet/aspnet:5.0、mcr.microsoft.com/dotnet/sdk:5.0系列镜像已迁移至legacy容器仓库，原路径拉取的镜像可能存在组件缺失、版本不匹配的问题。
3. 初始构建逻辑冲突：最早的单阶段Dockerfile使用runtime镜像直接承载本地编译的发布文件，如果本地是Windows环境编译的产物，直接放到Linux容器中运行也会触发框架适配报错。

方案1：优先升级到.NET LTS版本（推荐） #

直接将项目升级到.NET 6或.NET 8等长期支持版本，修改csproj文件的TargetFramework为对应版本（比如net6.0），同时替换Dockerfile中的基础镜像为对应LTS版本的官方镜像，即可解决镜像可用性问题，同时获得官方安全更新支持。

方案2：保留.NET 5的修复步骤 #

如果必须使用.NET 5，按以下步骤调整即可：

1. 修正Dockerfile的ENTRYPOINT配置，将dll名称改为和项目名匹配的HellowWorldAspNet.dll
2. 替换基础镜像为.NET 5的legacy官方地址，调整后的多阶段Dockerfile参考如下：

FROM mcr.microsoft.com/dotnet/legacy/sdk:5.0-alpine AS build
WORKDIR /app
COPY *.csproj ./
RUN dotnet restore
COPY . ./
RUN dotnet publish -c Release -o out

FROM mcr.microsoft.com/dotnet/legacy/aspnet:5.0-alpine AS runtime
WORKDIR /app
ENV ASPNETCORE_URLS=http://*:8080
COPY --from=build /app/out ./
ENTRYPOINT [ "dotnet", "HellowWorldAspNet.dll" ]

3. 在项目根目录新增.dockerignore文件，排除本地编译的干扰文件：

bin/
obj/
Dockerfile

4. 镜像构建完成后先本地验证再推送到GCR：

docker build -t hello-dotnet:v1 .
docker run -p 8080:8080 hello-dotnet:v1
# 本地访问127.0.0.1:8080验证服务正常后再推送到GCR部署

兜底方案：自包含部署 #

如果调整镜像后仍有问题，可以修改发布命令为自包含模式，将运行时整体打包进镜像：

# 构建阶段的发布命令修改为
RUN dotnet publish -c Release -o out --self-contained true -r linux-musl-x64
# 运行阶段可以直接使用alpine基础镜像，无需dotnet runtime镜像
FROM alpine:3.18 AS runtime
WORKDIR /app
RUN apk add --no-cache libgcc libstdc++ icu-libs
COPY --from=build /app/out ./
ENTRYPOINT [ "./HellowWorldAspNet" ]

内容的提问来源于stack exchange，提问作者Linda Lawton - DaImTo