SvelteKit路由问题：求助解决不带.html后缀无法访问路径的方法

核心原因 #

这个问题本质是服务器未将无后缀的路径映射到预渲染生成的.html文件，同时可能和SvelteKit的适配器配置有关。

具体解决步骤 #

1. 调整SvelteKit适配器配置（以adapter-static为例） #

如果使用的是@sveltejs/adapter-static，确保svelte.config.js里的配置符合需求：

• 若希望生成home.html这类文件（当前你的情况），无需修改trailingSlash，但要确保预渲染正确执行：

import adapter from '@sveltejs/adapter-static';

export default {
  kit: {
    adapter: adapter({
      pages: 'build',
      assets: 'build',
      fallback: null // 静态站点无需fallback，除非需要SPA模式
    }),
    prerender: {
      entries: ['*'] // 确保所有路由都被预渲染
    }
  }
};

2. 配置服务器重写规则 #

根据你使用的服务器类型添加对应规则，让无后缀路径自动匹配到对应的.html文件：

Nginx

在站点配置的location /块中添加：

try_files $uri $uri.html $uri/ =404;

这条规则会优先尝试访问原路径，找不到则尝试加.html后缀，再找不到就尝试目录，最后返回404。

Apache

首先确保启用mod_rewrite模块，然后在项目根目录（或build目录）的.htaccess文件中添加：

RewriteEngine On
# 排除已有后缀的文件（如.css/.js）和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将无后缀路径重写为对应.html文件
RewriteRule ^([^\.]+)$ $1.html [NC,L]

Caddy

在Caddyfile中添加：

@noExtension {
  not path *.html *.css *.js *.png *.jpg
}
rewrite @noExtension {path}.html

3. 验证SPA模式（可选） #

如果你的应用需要动态路由而非全预渲染，可以考虑启用SPA模式：
修改svelte.config.js的适配器配置，设置fallback: 'index.html'，同时服务器配置将所有请求指向index.html，由SvelteKit客户端路由处理。但这种模式下不会生成单独的.html文件，适合有动态内容的场景。

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