如何通过Docker镜像将Blazor应用部署至Google App Engine

问题根因 #

Google App Engine 弹性环境（Flex）的前置负载均衡默认仅转发请求到容器的8080端口，当前配置存在两个核心问题：

1. Dockerfile仅暴露80、443端口，Kestrel默认未监听8080端口，负载均衡无法和容器内应用建立连接
2. 未开启WebSockets支持与会话亲和性，Blazor Server依赖长连接通信，默认配置会导致连接建立失败

修复步骤 #

1. 修改Dockerfile配置 #

调整端口暴露规则，强制Kestrel监听0.0.0.0:8080，修改后完整Dockerfile内容如下：

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
# GAE Flex 默认转发到8080端口，仅需暴露该端口
EXPOSE 8080

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["CallAssistant.csproj", "."]
RUN dotnet restore "CallAssistant.csproj"
COPY . .
RUN dotnet build "CallAssistant.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "CallAssistant.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
# 配置Kestrel监听所有网卡的8080端口
ENV ASPNETCORE_URLS=http://+:8080
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "CallAssistant.dll"]

2. 补全app.yaml配置 #

替换原有极简配置，开启Blazor Server必需的WebSockets与会话亲和性，完整配置如下：

runtime: custom
env: flex
# 开启会话亲和性，保证Blazor长连接始终路由到同一实例
network:
  session_affinity: true
# 开启WebSockets支持
env_variables:
  ASPNETCORE_ENVIRONMENT: Production
  WEBSOCKET_ENABLED: "true"
# 调整健康检查配置，避免实例启动阶段被误判为异常
readiness_check:
  app_start_timeout_sec: 300
liveness_check:
  initial_delay_sec: 300
# 按需调整实例资源配置，最低配置即可运行Blazor Server
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

3. 本地验证后重新部署 #

• 先在本地执行镜像构建、运行命令，确认本地访问http://localhost:8080可以正常加载Blazor页面：

  docker build -t blazor-test .
  docker run -p 8080:8080 blazor-test
  

• 本地验证无问题后，在项目目录执行部署命令：

  gcloud app deploy
  

• 部署完成后执行gcloud app browse直接打开服务地址验证即可。

排查指引 #

如果调整配置后仍有异常，直接在Google Cloud控制台进入App Engine的日志页面，查看容器实例的标准输出日志，优先确认：

• 应用启动过程中是否有未捕获的异常
• 请求到达时Kestrel是否有对应的访问日志
• 8080端口是否在应用启动后正常处于监听状态

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