sveltekit 默认不将 `/api` 视为特殊路由前缀，若直接访问 `/api/login` 但未正确配置路由映射，会因无匹配的 get 处理器而返回 405；根本解法是避免依赖 `/api` 路径约定，改用标准文件系统路由或显式重定向。
在 SvelteKit 中，/api 并非内置的 API 路由根路径——它只是一个普通文件夹名，没有任何框架级语义。当你创建 src/routes/api/login/+server.ts 时，SvelteKit 实际注册的路由是 /api/login（完整路径），但该路由是否响应 POST 请求，完全取决于你是否在 +server.ts 中正确定义了 POST 处理器，且客户端请求必须精确匹配该路径与方法。
然而，你遇到的 405 Method Not Allowed（GET not allowed）错误，往往暴露一个关键事实：客户端实际发起的是 GET 请求，而非 POST。这通常由以下原因导致：
✅ 最常见原因：HTML 表单默认提交为 GET
如果你在 <form> 中未显式指定 method="POST"，浏览器会以 GET 方式提交，即使 JS 中调用了 fetch('/api/login', { method: 'POST' })，也可能因表单拦截、重定向或调试残留造成混淆。请确认你的 /auth/+page.svelte 中没有隐藏的 <form onsubmit> 未阻止默认行为。
✅ 路径映射冲突或服务端未生效
SvelteKit 的路由严格基于 src/routes/ 下的文件结构。/api/login 是合法路径，但需确保：
- 文件路径准确为 src/routes/api/login/+server.ts（注意大小写和扩展名）；
- 项目已重启（热更新有时不触发 +server.ts 重载）；
- 无同名 +page.svelte 或 +page.server.ts 拦截了该路径（优先级高于 +server.ts）。
❌ svelte.config.js 中手动配置 /login → +server.ts 映射是错误方案
问题答案中建议的 paths: { '/login': { post: '...' } } 完全无效：kit.paths 仅用于静态资源路径别名（如 assets, base），不支持运行时路由重写或方法映射。此配置会被忽略，且可能导致构建异常。
✅ 正确做法：使用标准文件系统路由（推荐）
将 API 端点放在 src/routes/login/+server.ts，即可通过 POST /login 访问——简洁、可靠、符合 SvelteKit 设计哲学：
// src/routes/login/+server.ts
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
export const POST: RequestHandler = async ({ request }) => {
const data = await request.json();
// 示例逻辑
if (data.email && data.password) {
return json({
employee: { email: data.email, id: 123 }
});
}
return json({ error: 'Invalid credentials' }, { status: 400 });
};前端调用保持不变：
const response = await fetch('/login', {
method: 'POST',
body: JSON.stringify({ email, password }),
headers: { 'content-type': 'application/json' }
});✅ 若必须保留 /api 前缀（如团队规范），请确保：
- 使用嵌套路由：src/routes/api/login/+server.ts ✅
- 客户端请求 URL 与文件路径严格一致：/api/login（不是 /api/login/ 或 /api/login/index）；
- 在 +server.ts 中同时导出 GET（可选）或明确拒绝，避免 405 模糊提示：
export const GET = () => new Response('Method Not Allowed', { status: 405 }); export const POST: RequestHandler = async ({ request }) => { /* ... */ };
? 总结：
- SvelteKit 没有“API 目录”魔法，/api 只是普通路径前缀；
- 405 错误本质是请求方法不匹配，优先检查网络面板确认实际发出的 HTTP 方法；
- 避免修改 svelte.config.js 的 paths 来处理路由逻辑——它不负责请求分发；
- 推荐扁平化路由（如 /login, /logout），语义清晰且零配置。
重启开发服务器并验证 curl -X POST http://localhost:5173/login -H "Content-Type: application/json" -d '{"email":"a@b.c","password":"123"}'，即可快速定位是否为环境问题。
