Github Action部署ASP.NET Core 8 Web API失败：找不到合适的Main方法

问题背景 #

尝试通过Github Action将ASP.NET Core 8 Web API经Docker部署至DigitalOcean Kubernetes，使用提供的Workflow和Dockerfile配置时，dotnet build步骤报错：

Program does not contain a static 'Main' method suitable for an entry point

修改构建命令加入/property:StartupObject=x.Api.Program后，仍报错：

Could not find 'x.Api.Program' specified for Main method...

本地通过docker-compose可正常构建，Visual Studio项目设置中无可用启动选项。

错误原因分析 #

1. Dockerfile构建命令笔误：构建步骤中使用./x.csproj作为构建目标，但发布步骤使用的是./x.Api.csproj，文件名输入错误导致构建的不是正确的Web API项目。
2. Docker构建上下文与路径不匹配：Github Action中指定的Docker构建上下文为x/x.Api，但Dockerfile中COPY项目文件的路径仍按根上下文设置，导致无法正确复制项目文件，构建时使用的项目文件不完整。
3. 不必要的StartupObject参数：ASP.NET Core 8默认使用顶级语句编写Program.cs，没有显式的Program类和Main方法，手动指定StartupObject会导致构建工具找不到对应类。

解决步骤 #

1. 修正Dockerfile中的构建命令笔误 #

将构建步骤中的./x.csproj替换为./x.Api.csproj，确保构建目标与发布目标一致：

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

2. 调整Dockerfile中的COPY路径以匹配构建上下文 #

由于Github Action中设置的Docker构建上下文是x/x.Api，Dockerfile中的路径需要基于该上下文调整，修正COPY命令：

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
# 基于x/x.Api上下文，直接复制当前目录的x.Api.csproj到src/x.Api/
COPY ["x.Api.csproj", "x.Api/"]
# 复制当前目录的nuget.config到src/
COPY ["nuget.config", "./"]
RUN dotnet restore "./x.Api/x.Api.csproj" --configfile nuget.config 
COPY . ./x.Api/
WORKDIR "/src/x.Api"
# 移除StartupObject参数，修正构建目标文件
RUN dotnet build "./x.Api.csproj" -c $BUILD_CONFIGURATION -o /app/build

3. 确认项目文件配置 #

检查x.Api.csproj文件，确保OutputType设置为Exe（ASP.NET Core Web API默认值，若被误改需修正）：

<PropertyGroup>
  <OutputType>Exe</OutputType>
  <TargetFramework>net8.0</TargetFramework>
  <Nullable>enable</Nullable>
  <ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>

4. 移除构建命令中的StartupObject参数 #

删除/property:StartupObject=x.Api.Program参数，ASP.NET Core 8的顶级语句项目会自动识别入口点，无需手动指定。

修改后的完整Dockerfile示例 #

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER app
WORKDIR /app
EXPOSE 80
EXPOSE 443

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

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

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "x.Api.dll"]

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