SvelteKit中LayoutServerLoad的Fetch在Kubernetes路由异常问题

问题描述 #

在SvelteKit应用的+layout.server.ts中，通过fetch请求API端点时，本地开发正常，但部署到Kubernetes集群后，请求被错误路由到Svelte应用本身，而非预期的API服务。已知Ingress规则配置正确（浏览器直接访问日志输出的apiUrl可正常路由到API），PUBLIC_API_URI已设为https://example.com/api。

核心原因 #

1. SvelteKit服务器端fetch的内部转发特性：当服务器端fetch请求的URL与当前应用同域名时，SvelteKit会默认跳过外部网络请求，直接将请求内部转发到自身的路由系统，不会经过Ingress。
2. K8s集群内部路由逻辑：集群内部发起的请求不会经过Ingress（Ingress主要处理外部流量），如果example.com在集群内部DNS中解析到Svelte应用的Service，请求会直接打到Svelte应用。

解决方案 #

方案1：使用API服务的内部Service地址（推荐） #

在K8s集群内，直接通过API服务的内部Service名称+端口访问，绕开外部域名和Ingress，既高效又避免路由冲突。

• 新增一个私有环境变量（不暴露给客户端），比如PRIVATE_API_URI，部署时设置为API服务的内部地址（例如http://api-service/api，api-service为API服务的K8s Service名称）。
• 修改+layout.server.ts代码：

import { env } from '$env/dynamic/private'; // 引入私有环境变量
import type { LayoutServerLoad } from './$types';

export const load: LayoutServerLoad = async ({ fetch }) => {
    const apiUrl = `${env.PRIVATE_API_URI}/some/subpath`;
    console.log('Fetching data', { apiUrl });
    const res = await fetch(apiUrl);
    
    if (!res.ok) {
        error(500, 'failed to fetch data');
    }

    // 后续逻辑及返回操作
};

方案2：强制跳过SvelteKit内部转发 #

如果必须使用外部域名，可以通过配置fetch选项或使用原生Node.js请求模块绕开内部转发：

• 方法A：修改fetch参数，添加redirect: 'manual'（部分场景下可触发外部请求）：

const res = await fetch(apiUrl, { redirect: 'manual' });

• 方法B：使用Node.js原生https模块发起请求：

import https from 'https';
import { env } from '$env/dynamic/public';
import type { LayoutServerLoad } from './$types';

export const load: LayoutServerLoad = async () => {
    const apiUrl = `${env.PUBLIC_API_URI}/some/subpath`;
    const res = await new Promise((resolve, reject) => {
        https.get(apiUrl, (response) => {
            resolve(response);
        }).on('error', reject);
    });

    if (res.statusCode !== 200) {
        error(500, 'failed to fetch data');
    }

    // 处理响应数据（需自行拼接响应体）
    const data = await new Promise<string>((resolve) => {
        let body = '';
        res.on('data', chunk => body += chunk);
        res.on('end', () => resolve(body));
    });

    // 后续逻辑
};

方案3：调整集群内部DNS解析 #

将example.com在集群内部DNS中解析到Ingress Controller的IP，使集群内部请求经过Ingress路由。但此方法会增加网络往返开销，不如方案1高效，仅在特殊场景下使用。

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