在AKS中部署.NET 8后台服务时提示未找到框架的问题求助

我用.NET 8.0创建了一个控制台应用作为后台服务，部署到AKS集群时出现如下错误：

You must install or update .NET to run this application.

App: /app/SampleService.dll
Architecture: x64
Framework: 'Microsoft.AspNetCore.App', version '8.0.0' (x64)
.NET location: /usr/share/dotnet/

No frameworks were found.

我的AKS集群已经部署了多个.NET 8.0的ASP.NET Core项目，只有这个应用是控制台程序而非Web API，所以对这个报错很困惑，希望得到解决指引。

相关代码如下：

Program.cs #

// Program.cs
static void Main(string[] args)
{
    IServiceCollection serviceDescriptors = new ServiceCollection();
    Host.CreateDefaultBuilder(args)
        .ConfigureHostConfiguration(configure =>
        {
            configure.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
                .AddJsonFile("appsettings.Development.json", optional: true, reloadOnChange: true)
                .Build();
        })
        .ConfigureServices((hostContext, services) =>
        {
            var appSettingsConfig = hostContext.Configuration.GetSection(nameof(AppSettings));

            services.Configure<AppSettings>(appSettingsConfig);

            services.AddHostedService<SampleBackgroundService>();
        })
        .Build()
        .Run();
}

Dockerfile #

// Dockerfile
FROM mcr.microsoft.com/dotnet/runtime:8.0 AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["src/SampleBackgroundService/SampleBackgroundService.csproj", "src/SampleBackgroundService/"]
RUN dotnet restore "./src/SampleBackgroundService/SampleBackgroundService.csproj"
COPY . .
WORKDIR "/src/src/SampleBackgroundService"
RUN dotnet build "./SampleBackgroundService.csproj" -c $BUILD_CONFIGURATION -o /app/build

FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./SampleBackgroundService.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
USER $APP_UID
ENTRYPOINT ["dotnet", "SampleBackgroundService.dll"]

核心原因 #

报错显示应用依赖Microsoft.AspNetCore.App框架，但当前使用的基础镜像mcr.microsoft.com/dotnet/runtime:8.0仅包含.NET Runtime，不包含ASP.NET Core Runtime。尽管项目是控制台后台服务，但可能依赖项中引入了ASP.NET Core相关包，导致运行时需要对应框架。

具体修复步骤 #

• 更换基础镜像：将Dockerfile中base阶段的镜像替换为包含ASP.NET Core Runtime的版本：

  FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
  

  该镜像同时包含.NET Runtime和ASP.NET Core Runtime，可满足应用的依赖需求。
• 清理不必要的依赖：打开项目的.csproj文件，检查是否存在无需的ASP.NET Core相关NuGet包（如Microsoft.AspNetCore.App或Microsoft.AspNetCore.*系列包）。若后台服务不需要ASP.NET Core功能，可移除这些引用，之后就能继续使用dotnet/runtime:8.0镜像。
• 重新构建部署：修改Dockerfile后，重新构建镜像并推送到容器仓库，再更新AKS中的部署即可。

本地验证（可选） #

可以先在本地运行容器测试修复效果：

docker build -t sample-service .
docker run sample-service

若本地运行正常，说明镜像配置无误，再部署到AKS即可。

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