SvelteKit生产环境页面仅返回重定向，本地正常求助排查

问题现象 #

生产环境部署在CentOS上，访问特定页面时仅返回<meta http-equiv="refresh" content="0;url=/">，无法渲染对应Svelte组件的HTML；但本地Ubuntu开发环境可正常返回正确内容。

补充细节：

• 请求该页面时，hooks.server.ts的handle、+layout.server.ts的load等位置的日志完全未触发，但外层Express服务器的日志正常记录
• Postman直接请求也得到相同的Meta重定向结果
• +layout.server.ts中存在认证失败抛出307重定向的逻辑，但生产环境返回状态码是200而非307，且无对应日志，可排除该逻辑影响
• 已在页面、+layout.svelte、hooks.server.ts、+layout.server.svelte中设置export const ssr = false; export const prerender = false;，问题依旧

依赖版本：

"svelte": "^3.55.0",
"svelte-check": "^2.7.1",
"svelte-preprocess": "^4.10.7",
"vite": "^4.0.0"

svelte.config.js配置：

import adapter from '@sveltejs/adapter-node';
import preprocess from 'svelte-preprocess';

const config = {
    preprocess: preprocess(),
    kit: {
        adapter: adapter(),
        prerender: { entries: [] }
    }
};

export default config;

排查与解决建议 #

1. 检查文件系统大小写匹配 #

CentOS是区分大小写的文件系统，Ubuntu默认不区分。确认生产环境的路由文件命名与本地完全一致，比如本地的+page.svelte不能在生产环境被命名为+Page.svelte，否则会导致路由无法匹配，触发默认重定向。

2. 验证路由与Base路径配置 #

• 若生产环境设置了BASE_PATH环境变量，需在svelte.config.js中配置kit.paths.base，或确保请求URL包含正确的base路径
• 检查反向代理（如Nginx）的路径重写规则，确认请求是否正确转发到SvelteKit服务，避免代理层截断或修改了路由路径

3. 排查Adapter-Node部署逻辑 #

• 确认生产环境是通过npm run build生成的build目录启动服务，而非直接使用dev命令
• 尝试绕过反向代理，直接在生产环境启动SvelteKit服务并访问，排除代理层的干扰

4. 检查全局错误处理与Fallback逻辑 #

• 查看项目中是否存在+error.svelte或+error.server.ts文件，是否在其中设置了Meta重定向到根路径
• 检查hooks.server.ts中是否有未被日志覆盖的路由匹配失败处理分支

5. 清理构建缓存与依赖 #

• 删除生产环境的node_modules和build目录，重新安装依赖并构建，避免缓存或依赖版本不一致导致的问题
• 对比本地与生产环境的package-lock.json，确保所有依赖版本完全一致

6. 开启调试日志定位问题 #

在生产环境启动服务时，设置环境变量获取详细路由处理日志：

DEBUG=sveltekit:* node build/index.js

通过日志查看请求的路由匹配过程，确认为何未触发预期的页面渲染逻辑。

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