从GitHub持续部署ASP.NET WebAPI到Cloud Run遇启动故障求助

核心问题定位 #

日志中Sample_API.API.runtimeconfig.json缺失，说明容器内应用文件不完整，或发布方式导致.NET运行时依赖处理异常。Cloud Run要求应用监听PORT环境变量指定端口（此处为8080），同时需保证.NET启动依赖文件齐全。

修正Dockerfile（关键步骤） #

采用ASP.NET容器化标准的多阶段构建，避免依赖缺失：

# 构建阶段：用SDK镜像编译发布
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
# 复制项目文件并还原依赖
COPY ["Sample_API.API/Sample_API.API.csproj", "Sample_API.API/"]
RUN dotnet restore "Sample_API.API/Sample_API.API.csproj"
# 复制全部代码并发布
COPY . .
WORKDIR "/src/Sample_API.API"
# 发布为框架依赖模式（避免自包含依赖问题），指定输出目录
RUN dotnet publish "Sample_API.API.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段：用ASP.NET运行时镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
COPY --from=build /app/publish .
# 设置环境变量，让ASP.NET监听PORT指定端口
ENV ASPNETCORE_URLS=http://0.0.0.0:${PORT:-8080}
# 启动应用（确保dll名称与项目输出一致）
ENTRYPOINT ["dotnet", "Sample_API.API.dll"]

关键参数说明 #

• -p:UseAppHost=false：禁用独立可执行文件生成，强制用dotnet命令启动，规避自包含模式的依赖缺失
• ASPNETCORE_URLS=http://0.0.0.0:${PORT:-8080}：让应用监听所有网卡的PORT端口（Cloud Run会自动注入该环境变量）
• 确认ENTRYPOINT中的dll名称与你的项目输出匹配，比如项目名为Sample_API则对应Sample_API.dll

验证cloudbuild.yaml配置 #

确保Cloud Build步骤正确执行镜像构建：

steps:
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'gcr.io/$PROJECT_ID/sample-api', '.']
images:
- 'gcr.io/$PROJECT_ID/sample-api'

本地预验证（减少部署调试成本） #

在本地Docker环境模拟Cloud Run环境测试：

# 构建镜像
docker build -t sample-api .
# 运行容器并指定PORT=8080
docker run -p 8080:8080 -e PORT=8080 sample-api
# 测试接口可用性
curl http://localhost:8080/weatherforecast

日志细节排查 #

若问题仍存在，通过Cloud Run控制台查看完整日志：

• 确认PORT环境变量是否正确注入
• 连接容器检查文件完整性：gcloud beta run services exec <service-name> -- /bin/bash，查看是否存在Sample_API.API.runtimeconfig.json和libhostpolicy.so

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