.NET 8容器化应用Docker配置异常：API端点访问失败求助

核心问题定位 #

从现象和配置来看，问题集中在容器网络通信和Docker配置语法错误两个维度，以下是具体修复步骤：

1. 修复Docker Compose语法错误 #

你的server服务的develop.watch配置存在缩进错误，导致Compose解析失败，直接影响服务启动或热重载逻辑：

services:
  server:
    build:
      context: .
      target: final
    ports:
      - '5286:80'
    command: --init-file /server/data/Database.sql
    depends_on:
      db:
        condition: service_healthy
    develop:
        watch:
          - action: sync
            path: ./server
            target: /src/server  # 修正缩进，将action配置归到watch子层级下
  # 其他服务配置保持不变

2. 修正前端API请求地址 #

前端容器内的localhost指向容器自身，而非宿主机，导致HTMX请求无法穿透到后端服务：

• 若使用Docker Compose默认网络，前端可直接通过后端服务名server+容器内端口（80）调用API，例如http://server/api/register
• 若需通过宿主机访问，可在前端代码中使用宿主机IP（如http://192.168.x.x:5286/api/register），但该方式不适合跨环境部署

3. 确保.NET后端监听正确地址 #

.NET 8默认仅监听localhost，容器内需要监听所有网卡才能被外部（包括其他容器）访问：

• 方式一：在Program.cs中添加Kestrel配置

  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenAnyIP(80); // 监听容器内80端口，对应Compose映射的宿主机5286端口
  });
  

• 方式二：通过环境变量配置，在Docker Compose的server服务中添加：

  environment:
    - ASPNETCORE_URLS=http://+:80
  

4. 配置CORS允许跨域请求 #

前端运行在8080端口，后端在5286端口，浏览器会触发CORS验证，需在.NET后端启用CORS：

// Program.cs中添加
builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowFrontend", policy =>
    {
        policy.WithOrigins("http://localhost:8080") // 指定前端地址
              .AllowAnyMethod()
              .AllowAnyHeader();
    });
});

// 注意中间件顺序：放在UseRouting之后，UseAuthorization之前
app.UseCors("AllowFrontend");

5. 清理无效配置 #

你的server服务挂载了./mysql-data:/var/lib/mysql，该目录属于db服务，server无需挂载，建议移除：

server:
  # 移除以下无效配置项
  # volumes: 
  #       - ./mysql-data:/var/lib/mysql

6. 验证后端服务状态 #

• 执行docker compose logs server查看后端启动日志，确认是否有端口监听失败、数据库连接异常等报错
• 在宿主机直接访问http://localhost:5286/swagger，若无法访问说明后端服务未正常启动或端口映射错误

验证流程 #

1. 停止并清理所有容器：docker compose down -v
2. 重新构建并启动服务：docker compose up --build
3. 访问http://localhost:8080/views/register/register.html提交请求，查看Chrome开发者工具Network标签，确认请求是否正常到达后端

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