使用docker-compose部署Blazor和Web API容器到Azure失败如何解决

• HTTPS终止逻辑不匹配
  Azure容器服务（包含容器应用/Web App for Containers默认在边缘网关层完成HTTPS证书卸载，转发到业务容器的请求均为HTTP协议。你在nginx中配置的HTTPS监听/强制跳转逻辑时，要么因为容器侧无有效SSL证书导致nginx启动失败，要么触发HTTP→HTTPS重定向死循环，导致站点无法访问。
• 端口配置冗余冲突
  你为wasm容器同时映射443端口但未挂载有效SSL证书，nginx启动时无法完成SSL握手，直接抛出异常退出，导致服务不可用。
• Blazor反向代理适配缺失
  Blazor没有正确配置X-Forwarded-Proto头，导致服务端/前端路由、API调用时协议识别错误，触发跨域或资源加载失败。

1. 修正nginx配置，适配Azure反向代理规则 #

移除nginx中HTTPS监听、强制跳转相关配置，新增反向代理头识别逻辑，参考配置如下：

server {
    listen 80;
    server_name _;

    # 适配Azure HTTPS终止头传递
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # Blazor WASM静态资源路由
    location / {
        root /usr/share/nginx/html;
        try_files $uri $uri/ /index.html;
    }

    # 后端API转发规则，按需配置
    location /api {
        proxy_pass http://webapi:你的WebAPI容器服务名:WebAPI监听端口;
        proxy_set_header Host $host;
    }
}

2. 调整docker-compose配置 #

移除wasm容器443端口映射，仅保留80端口暴露即可，HTTPS跳转逻辑由Azure网关统一处理，参考配置：

version: '3.8'
services:
  blazorwasm:
    image: 你的Docker Hub Blazor镜像地址
    ports:
      - "80:80"
    depends_on:
      - webapi
    restart: always
  webapi:
    image: 你的Docker Hub Web API镜像地址
    expose:
      - "WebAPI监听端口"
    restart: always

3. 配置Azure服务规则 #

• 进入你部署的Azure服务配置页，开启HTTPS only开关，所有HTTP请求会由Azure网关自动跳转至HTTPS，无需容器侧处理
• 配置Web API的CORS规则，将Blazor站点的Azure域名添加到允许跨域源列表
• 查看容器实例日志，确认两个容器均正常启动，无镜像拉取、端口冲突类报错

4. 修正Blazor服务配置 #

在Blazor服务的Program.cs文件中添加转发头支持，确保服务能识别正确的请求协议：

// 注册转发头服务
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    options.KnownProxies.Clear();
    options.KnownNetworks.Clear();
});

// 中间件需放在管道最开头
app.UseForwardedHeaders();

如果是Blazor WASM前端直接调用后端API，需要将API请求地址替换为Azure部署后的实际域名，不要使用容器内部服务名。

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