Docker环境下前端容器无法连接后端API问题求助

问题分析 #

1. 端口不匹配：前端请求的5000端口并非后端容器内部的监听端口——后端容器对外映射的5001是主机端口，容器内部实际监听的是443（HTTPS）或80（HTTP）端口，容器间通信需使用容器内部端口。
2. 协议不一致：本地Postman用https://localhost:5001访问正常，说明后端是HTTPS服务，但前端用http://backend:xxx发起请求，协议不匹配直接导致连接失败。
3. HTTPS证书问题：如果后端使用自签名SSL证书，前端容器默认会拒绝未信任的证书，也会引发连接错误。

解决方案 #

方案1：调整前端请求为HTTPS+正确容器端口 #

直接修改前端axios请求地址，使用HTTPS协议和容器内部的443端口，并处理自签名证书问题（仅开发环境）：

const https = require('https');

axios.get(`https://backend:443/api/health`, {
  httpsAgent: new https.Agent({ rejectUnauthorized: false })
})

生产环境请替换为合法的SSL证书，移除rejectUnauthorized: false配置。

方案2：让后端同时监听HTTP端口（开发环境更便捷） #

若不想处理HTTPS证书，可修改后端配置启用HTTP监听：

1. 在后端Program.cs中添加HTTP端口监听：

var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel同时监听HTTP 80和HTTPS 443
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(80);
    options.ListenAnyIP(443, o => o.UseHttps());
});

// ... 其他业务配置

var app = builder.Build();
app.Run();

2. 调整前端请求为HTTP+80端口：

axios.get(`http://backend:80/api/health`)

方案3：验证容器间网络连通性 #

先通过命令确认容器间网络是否正常，排除网络问题：

1. 进入前端容器，测试后端连通性：

# 测试HTTPS（跳过证书验证）
docker exec -it frontend curl https://backend:443/api/health -k

# 若启用了HTTP，测试HTTP
docker exec -it frontend curl http://backend:80/api/health

如果命令能返回正常数据，说明网络无问题，问题出在前端代码请求配置。

2. 查看后端容器日志，确认服务启动状态：

docker logs <backend容器名称>

检查日志中是否存在Now listening on: http://[::]:80或Now listening on: https://[::]:443的输出，确认端口监听正常。

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