SvelteKit表单POST请求405错误：无可用动作问题排查

我在routes/manager路径下的+page.svelte中创建了POST表单，指定action为?/manageFile并使用use:enhance，同时在同路径的+page.server.ts中定义了对应的manageFile动作，但始终收到405 POST method not allowed. No actions exist for this page错误，移除use:enhance后问题依然存在。

表单代码（+page.svelte） #

<form 
id="file_selection" 
action="?/manageFile" 
method="post"
use:enhance={() => {
    waiting = true;

    return async ({update, result}) => {
        await update();

        console.log(result);
    }
}}>
    <h1>
        Veuillez choisir ou déposer votre <span id="stressed"
            >relevé bancaire</span
        >.
    </h1>
    <input type="file" id="fileInput" name="fileInput" bind:files />
    <label for="file">
        {message}
    </label>
    <p>Types de fichier accepté: <i>.xlsx</i> ; <i>.csv</i></p>
    <button class="cta" type="submit">Continuer</button>
</form>

服务器动作代码（+page.server.ts） #

import type { Actions } from '@sveltejs/kit';

export const actions: Actions = {
    manageFile: async ({ request }) => {
        console.log(await request.formData());
    }
}

排查与解决步骤 #

1. 核对文件路径一致性

确保+page.server.ts和+page.svelte完全处于同一routes/manager目录下，SvelteKit对路由路径的大小写、层级结构要求严格，避免出现目录名大小写错误（比如routes/Manager）或嵌套位置错误。

2. 验证动作导出正确性

• 确认Actions类型导入无拼写错误（不要写成单数Action）；
• 确保manageFile函数名与表单action中的名称完全匹配（大小写敏感，比如不能写成managefile）。

3. 修复表单method属性的语法问题

原代码中method="post"的引号存在转义异常，实际编写时要确保双引号完整闭合，即method="post"，缺失闭合引号会导致浏览器解析请求方法错误。

4. 清理缓存并重启开发服务器

SvelteKit开发服务器可能缓存旧路由配置，执行以下操作：

• 终止当前服务器（Ctrl+C）；
• 删除项目根目录下的.svelte-kit文件夹；
• 重新启动服务器（npm run dev/pnpm dev）。

5. 排查路由冲突

检查routes/manager目录下是否存在+server.ts文件，如果有，确认其中没有定义拦截POST请求的逻辑，避免覆盖页面动作的处理。

6. 确认请求路径与方法

打开浏览器开发者工具，查看表单提交后的网络请求：

• 确认请求URL为/manager?/manageFile；
• 确认请求方法为POST，未被意外重定向为GET。

内容的提问来源于stack exchange，提问作者Eli-ott