Docker化.NET API无法响应localhost GET请求，求排查建议

我有一个运行在容器中的Docker化.NET API，向API端点（如http://localhost:5000/api/trips）发送GET请求时没有任何响应。使用的是.NET 8版本。

相关代码片段 #

docker-compose.yml #

services:
   mydb:
     container_name: my-db
     image: mcr.microsoft.com/mssql/server:2022-latest
     environment:
       - ACCEPT_EULA=Y
       - SA_PASSWORD=Password12345!
     networks: 
       - backend
     ports:
       - "1433:1433"
     volumes:
       - sql_data:/var/opt/mssql

   rest_api:
     container_name: my-api
     build:
       context: .
       dockerfile: rest_api/Dockerfile
     ports:
       - "5000:80"
       - "8081:443"
     environment:
       - ASPNETCORE_ENVIRONMENT=Development
     networks: 
       - backend
     depends_on:
       - mydb

volumes:
  sql_data:
    driver: local

networks:
  backend:
    driver: bridge

Dockerfile #

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build

WORKDIR /app

COPY rest_api/*.csproj ./rest_api/

RUN dotnet restore ./rest_api/rest_api.csproj

COPY . ./

RUN dotnet build ./rest_api/rest_api.csproj -c Release -o /app/build

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

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "rest_api.dll"]

Controller代码 #

[Route("api/trips")]
[ApiController]
public class TripsController : ControllerBase
{
    private readonly IServiceManager _service;

    public TripsController(IServiceManager service) => _service = service;

    [HttpGet]
    public async Task<IActionResult> GetTrips()
    {
        var trips = await _service.TripService.GetAllTripsAsync(trackChanges: false);
        return Ok(trips);
    }
}

已执行的排查步骤 #

• 查看Docker Compose日志：检查了rest_api容器的日志，未发现明显错误信息。
• 验证API端点：反复检查了api/trips端点的控制器实现，确认[HttpGet]特性和动作方法配置正确。
• 检查Docker Compose配置：确认端口映射（如5000:80）配置正确。
• 使用curl测试：尝试直接用curl发送请求，同样无响应。
• 重启容器：重启了rest_api容器，但问题仍存在。

容器日志输出（docker logs my-api） #

warn: Microsoft.AspNetCore.DataProtection.Repositories.FileSystemXmlRepository[60]
  Storing keys in a directory '/root/.aspnet/DataProtection-Keys' that may not be persisted outside of the container. Protected data will be unavailable when container is destroyed. For more information go to https://aka.ms/aspnet/dataprotectionwarning
warn: Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager[35]
  No XML encryptor configured. Key {518f52c6-dd78-4287-ae48-641ec1f8ccfa} may be persisted to storage in unencrypted form.
info: Microsoft.Hosting.Lifetime[14]
  Now listening on: http://[::]:8080
info: Microsoft.Hosting.Lifetime[0]
  Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
  Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
  Content root path: /app

故障排查思路与建议 #

1. 修正端口映射不匹配问题 #

从日志可明确看到，API在容器内实际监听的是8080端口，但docker-compose配置中把主机5000端口映射到了容器的80端口，请求根本无法到达API服务，这是核心问题。

解决方式二选一：

• 调整docker-compose.yml的端口映射，将rest_api的ports改为：

  ports:
    - "5000:8080"
    - "8081:443"
  

• 强制API在容器内监听80端口：在Dockerfile的final阶段添加环境变量：

  FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
  WORKDIR /app
  ENV ASPNETCORE_URLS=http://+:80
  COPY --from=publish /app/publish .
  ENTRYPOINT ["dotnet", "rest_api.dll"]
  

2. 解决数据库就绪延迟问题 #

depends_on仅保证mydb容器启动，不代表SQL Server服务完全就绪。API启动时若尝试连接未就绪的数据库，可能导致请求阻塞。

解决方法：

• 在mydb服务中添加健康检查，确保SQL Server就绪后再启动API：

  mydb:
    # ... 原有配置 ...
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P Password12345! -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
  

  同时修改rest_api的depends_on配置：

  rest_api:
    # ... 原有配置 ...
    depends_on:
      mydb:
        condition: service_healthy
  

• 在API中添加数据库连接重试逻辑，使用Polly等库实现失败重试。

3. 容器内直接测试API连通性 #

执行命令进入API容器：

docker exec -it my-api bash

在容器内用curl测试本地API：

curl http://localhost:8080/api/trips

• 若能拿到响应：确认是端口映射问题，按步骤1修正即可。
• 若仍无响应：说明API内部逻辑存在阻塞，继续排查。

4. 验证控制器方法是否被调用 #

在GetTrips方法开头添加日志输出，确认请求是否到达控制器：

[HttpGet]
public async Task<IActionResult> GetTrips()
{
    Console.WriteLine("GetTrips方法已触发");
    var trips = await _service.TripService.GetAllTripsAsync(trackChanges: false);
    return Ok(trips);
}

重新构建并启动容器后，查看日志：

docker logs my-api

• 若看不到该日志：说明请求未到达控制器，需检查路由配置、中间件是否拦截请求。
• 若能看到该日志：说明问题出在TripService.GetAllTripsAsync方法，需排查数据库查询是否阻塞、服务注入是否异常。

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