Docker部署的SvelteKit通过NGINX代理调用同域名API时挂起

问题根源 #

你的SvelteKit应用在Docker容器内通过event.fetch("https://example.com/api/users/me")发起请求时，会触发容器内部到外部域名的循环依赖：容器尝试访问外部域名example.com，而该域名指向宿主机的NGINX代理，NGINX又转发回容器网络，但Docker默认网络配置下，容器无法直接通过外部域名访问宿主机的代理服务，最终导致请求无限挂起。

修复方案 #

1. 改用内部网络直接访问.NET服务 #

最直接的解决方式是让SvelteKit服务器端绕过NGINX，直接访问.NET容器的内部地址：

// 方案A：使用宿主机内网IP（例如192.168.1.100）
event.fetch("http://192.168.1.100:5000/api/users/me")

// 方案B：使用Docker自定义网络的容器名（推荐）
// 先创建自定义网络：docker network create app-network
// 启动.NET容器时加入网络：--network app-network --name dotnet-api
// 启动SvelteKit容器时加入同一网络：--network app-network
event.fetch("http://dotnet-api:5000/api/users/me")

2. 配置容器hosts映射（保留外部域名请求） #

如果需要继续使用https://example.com的请求地址，可以在启动SvelteKit容器时添加hosts映射，将域名指向宿主机内网IP：

docker run --add-host example.com:192.168.1.100 [你的SvelteKit镜像名]

3. 用环境变量管理API地址（避免硬编码） #

在SvelteKit中使用服务器端专属环境变量（前缀为PRIVATE_）存储API地址，启动Docker容器时传入该变量：

// 在hooks.server.ts或+page.server.ts中调用
const apiBaseUrl = process.env.PRIVATE_API_BASE_URL;
const response = await event.fetch(`${apiBaseUrl}/users/me`);

启动容器时传入变量：

docker run -e PRIVATE_API_BASE_URL=http://dotnet-api:5000/api [你的SvelteKit镜像名]

4. 排查网络连通性 #

• 进入SvelteKit容器内部执行curl http://192.168.1.100:5000/api/users/me，验证是否能正常获取结果，定位是网络问题还是代码问题
• 检查宿主机防火墙规则，确保允许Docker容器访问5000端口
• 查看NGINX的access.log和error.log，确认请求是否到达代理层

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