如何部署使用adapter-static和动态路由的SvelteKit项目？

直接解决方案：配置Firebase Hosting重写规则 #

你的项目用adapter-static生成了静态文件，但Firebase Hosting默认无法识别[...unknown].html这类动态命名的文件，需要通过重写规则让服务器把请求转发到对应的预渲染文件。

1. 在项目根目录创建或修改firebase.json，添加如下配置：

{
  "hosting": {
    "public": "build",
    "rewrites": [
      {
        "source": "/category/**",
        "destination": "/category/[...path].html"
      },
      {
        "source": "**",
        "destination": "/[...unknown].html"
      }
    ]
  }
}

这个规则会把所有/category/开头的请求转发到/category/[...path].html，其他所有请求转发到/[...unknown].html，和SvelteKit的路由匹配逻辑一致。

2. 重新部署项目到Firebase Hosting即可生效。

动态路由运行机制 #

SvelteKit的动态路由（包括catch-all路由[...xxx]）的工作逻辑分两种场景：

1. 开发/Preview模式：由SvelteKit内置的Node.js服务器处理请求，服务器会解析URL路径，匹配对应的路由组件（比如/foo/bar会匹配[...unknown]/+page.svelte），然后动态渲染页面。
2. 静态构建（adapter-static）：构建时会为动态路由生成带占位符的HTML文件（比如[...unknown].html），但静态服务器本身不懂SvelteKit的路由规则，无法自动把/foo/bar这类路径映射到[...unknown].html，必须通过服务器的重写规则来完成路径映射。

catch-all路由[...xxx]是优先级最低的路由，只有当其他具体路由（比如/normal、/category）都不匹配时，才会被触发。

正确解析动态路由的服务器要求 #

要让静态构建的SvelteKit动态路由正常工作，服务器必须支持**URL重写（Rewrite）**功能，核心是把请求路径转发到对应的预渲染动态HTML文件：

• Firebase Hosting：通过firebase.json的rewrites字段配置，如上面的示例；
• Nginx：用try_files指令，比如：

  location / {
    try_files $uri $uri/ /[...unknown].html;
  }
  location /category/ {
    try_files $uri $uri/ /category/[...path].html;
  }
  

• Netlify/Vercel：Netlify可以在_redirects文件中配置，Vercel会自动识别SvelteKit的静态构建产物，复杂路由可能需要手动配置重写规则。

所有配置的核心逻辑都是：让服务器把未匹配到具体静态文件的请求，转发到对应的catch-all路由HTML文件，由SvelteKit在客户端完成路由匹配和页面渲染。

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