SvelteKit 中 /api 目录下端点返回 405 错误的解决方案

✅ 路径映射冲突或服务端未生效
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 });
};

前端调用保持不变：

Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果，以便快速有效地分享您的想法。

下载

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"}'，即可快速定位是否为环境问题。