SvelteKit动态路由始终返回404 NotFound问题求助

问题背景 #

• 项目：SvelteKit v2.5.10，首次大型项目，仅使用SSR服务端组件，API为独立ASP.NET Core项目
• 路由结构：
  • /src/routes/overview/+page.svelte：对象概览页（可正常访问）
  • /src/routes/overview/[objectId]/+page.svelte：单个对象详情页（访问时返回404，无额外错误日志）
• 已尝试无效方案：删除node_modules重装、删除.svelte-kit重启、构建后用preview模式运行、改用node-adapter、重命名动态ID文件夹
• 配置：Vite仅开启HTTPS，svelte.config.js未修改

排查步骤 #

1. 确认路由文件结构准确性 #

• 检查[objectId]文件夹名称：必须是纯方括号包裹的标识符，不能包含空格、特殊字符（下划线、短横线除外）
• 核对路径拼写：确保[objectId]确实嵌套在overview目录下，无路径层级错误或拼写失误（比如误写为overveiw）

2. 验证访问路径格式 #

访问动态路由时必须传入实际ID值，比如：

• 正确路径：https://localhost:5173/overview/123（123为真实objectId）
• 错误路径：https://localhost:5173/overview/[objectId]（直接访问带方括号的占位符路径）

3. 查看SvelteKit路由注册日志 #

启动开发服务器后，终端会打印所有已注册的路由列表。正常情况下应出现：

Routes:
  GET /overview (src/routes/overview/+page.svelte)
  GET /overview/[objectId] (src/routes/overview/[objectId]/+page.svelte)

如果未看到动态路由记录，说明SvelteKit未识别到该路由文件，需重点检查文件命名或路径。

4. 排查路由冲突 #

• 检查overview目录下是否存在+server.js、+layout.server.js等文件，是否有自定义路由逻辑拦截了动态路由
• 确认项目中无通配符路由（如[[...slug]]），此类路由会优先匹配，导致动态路由失效

5. 测试极简复现场景 #

创建极简动态路由验证基础配置是否正常：

1. 在src/routes/下新建test/[id]/+page.svelte，内容如下：

<h1>测试动态页：{params.id}</h1>
<script>
    export let params;
</script>

2. 访问https://localhost:5173/test/456，若仍404则为项目基础配置/环境问题；若正常显示则说明原overview/[objectId]路径存在特定问题

6. 升级SvelteKit版本 #

旧版本可能存在路由识别bug，尝试升级到v2.x分支最新稳定版：

npm install @sveltejs/kit@latest

7. 排除HTTPS配置影响 #

临时注释Vite配置中的HTTPS部分，改用HTTP访问，验证是否因证书或HTTPS配置导致路由解析异常：

// server: {
//     https: {
//         key: fs.readFileSync('development.key'),
//         cert: fs.readFileSync('development.cert')
//     }
// }

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