ASP.NET Core 6通过Dockerfile暴露端口无效，请求排查

针对你遇到的ASP.NET Core 6 Docker部署后返回HTTP 404的问题，以下是几个常见原因和对应解决办法：

1. Swagger仅在开发环境可用 #

你的代码中Swagger仅在Development环境下启用，但Docker镜像使用Release模式构建，直接访问http://localhost:8080/swagger自然会返回404。

解决方式：

• 临时测试：在Dockerfile的final阶段添加环境变量，强制启用开发环境：

  FROM base AS final
  WORKDIR /app
  COPY --from=publish /app/publish .
  ENV ASPNETCORE_ENVIRONMENT=Development
  ENTRYPOINT ["dotnet", "WebApplication2.dll"]
  

• 生产环境需求：如果需要在生产环境开放Swagger，修改Program.cs的环境判断逻辑：

  // 根据需求调整环境范围，比如允许生产环境启用
  if (app.Environment.IsDevelopment() || app.Environment.IsProduction())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  

2. 缺少实际的API控制器端点 #

虽然你的Program.cs配置了AddControllers和MapControllers，但如果项目中没有创建任何控制器类，所有API请求都会返回404。

解决方式：
添加一个示例控制器验证，比如：

using Microsoft.AspNetCore.Mvc;

namespace WebApplication2.Controllers;

[ApiController]
[Route("[controller]")]
public class TestController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        return Ok("Hello from Docker!");
    }
}

重新构建镜像并运行后，访问http://localhost:8080/test测试是否正常响应。

3. 应用监听地址限制 #

ASP.NET Core 6默认仅监听容器内部的localhost地址，外部请求无法穿透到容器内的应用。

解决方式：
任选一种方式即可：

• 在Dockerfile的final阶段添加环境变量：

  ENV ASPNETCORE_URLS=http://+:80
  

• 修改Program.cs的app.Run()指定监听所有网卡：

  app.Run("http://0.0.0.0:80");
  

• 运行容器时传递环境变量：

  docker run -p 8080:80 -e ASPNETCORE_URLS=http://+:80 sample
  

4. Docker构建上下文路径错误 #

你的Dockerfile中COPY ["WebApplication2/WebApplication2.csproj", "WebApplication2/"]依赖于正确的构建上下文，如果执行docker build时的当前目录不是解决方案根目录（包含WebApplication2文件夹的上级目录），会导致文件复制不完整，应用缺失必要组件。

解决方式：
确保执行docker build命令时，当前工作目录是解决方案的根目录，或者调整Dockerfile中的路径匹配你的实际项目结构。

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