SvelteKit + adapter-static部署时URL未匹配基础路径问题排查

安全阿岳

2026-7-2

问题分析与解决方案

核心问题1：base路径拼写错误

你的svelte.config.js里paths.base写的是/examle-url，但你描述中说设置的是/example——明显是拼写错误（examle少了一个p）。这个错误会导致$app/paths导出的base值不符合预期，直接造成链接生成异常。

核心问题2：静态适配器与路径配置缺失

使用adapter-static时，需要配合路径尾斜杠的配置，否则静态站点的相对路径容易出现叠加问题：

修正svelte.config.js配置

先把base路径拼写改对，比如改成你需要的/example；

给adapter添加trailingSlash配置，确保路径一致性：

import adapter from '@sveltejs/adapter-static';
/** @type {import('@sveltejs/kit').Config} */
const config = {
    kit: {
        adapter: adapter({
            trailingSlash: 'always' // 或者'never'，根据你的站点需求选择
        }),
        paths: {
            base: '/example' // 修正拼写后的base路径
        }
    }
};

export default config;

统一布局中的路径处理
虽然你已经在+layout.svelte中引入了base，但建议同时在+layout.js中添加路径尾斜杠的配置，确保全局路径规则一致：
```
export const prerender = true;
export const trailingSlash = 'always'; // 和adapter配置保持一致
```
测试方式正确化
不要直接双击打开build后的HTML文件（file://协议会破坏相对路径逻辑），用本地服务器运行build产物，比如：
```
pnpm add -g serve
serve build
```
再通过http://localhost:3000/example访问测试。
排查版本问题
如果上述配置修正后仍有问题，升级SvelteKit和适配器到最新稳定版：
```
pnpm up @sveltejs/kit @sveltejs/adapter-static
```