如何在 Laravel 中正确配置 POST 路由与控制器方法实现数据库写入

本文详解 laravel 中 post 接口 500 错误的典型原因，重点解决路由绑定错误、csrf 头缺失、控制器方法未定义及请求处理不规范等问题，并提供可直接运行的修复代码和最佳实践。

在 laravel 中遇到 500 internal Server Error 且日志显示 Method IlluminatehttpRequest::show does not exist，这并非前端问题，而是后端路由与控制器方法严重不匹配导致的致命错误。根本原因在于：你为 /Event/create 路由指定了 CalendarController@add 方法，但该控制器中并未定义 add() 方法；更关键的是，错误日志中出现的 Request::show() 异常，往往源于 Laravel 框架在尝试动态调用一个不存在的方法时（例如误将 Request 实例当作控制器调用），而其根源通常是路由闭包或控制器方法签名错误引发的底层解析异常。

✅ 正确的路由与控制器配置

首先，确保路由指向真实存在的控制器方法。Laravel 官方推荐使用 restful 命名约定，因此建议将创建逻辑放在 store() 方法中（而非 add()）：

// routes/api.php use appHttpControllersCalendarController;  Route::post('/event/create', [CalendarController::class, 'store']);

⚠️ 注意：不要重复注册相同逻辑的路由（如同时定义 /home 和 /event/create 指向同一方法），避免混淆；且 api.php 中的路由默认已启用 CSRF 保护豁免（仅限 api 中间件组），但你的前端请求仍需通过 web 中间件（如 /home 页面）发起，因此必须携带有效的 CSRF Token。

✅ 补全 CalendarController 的 store 方法

当前 CalendarController 缺失处理 POST 请求的核心逻辑。请按以下方式补全，并使用 Laravel 的请求验证与模型操作标准流程：

// app/Http/Controllers/CalendarController.php namespace AppHttpControllers;  use IlluminateHttpRequest; use AppModelsBooking; use IlluminateSupportFacadesValidator;  class CalendarController extends Controller {     // ... index() 方法保持不变      public function store(Request $request)     {         // 1. 验证必填字段（根据 Booking 模型字段调整）         $validator = Validator::make($request->all(), [             'title' => 'required|string|max:255',             'resourceId' => 'required|integer',             'start_date' => 'required|date',             'end_date' => 'required|date|after_or_equal:start_date',         ]);          if ($validator->fails()) {             return response()->json([                 'success' => false,                 'errors' => $validator->errors()             ], 422);         }          // 2. 创建并保存记录         $booking = Booking::create($request->only([             'title', 'resourceId', 'start_date', 'end_date'         ]));          return response()->json([             'success' => true,             'message' => 'Event created successfully',             'data' => $booking         ], 201);     } }

✅ 前端 fetch 请求修正要点

你当前的 js 代码存在两个关键缺陷：

• ❌ headers 中使用了 “X-CSRF-Token” — Laravel 默认识别的是 “X-XSRF-TOKEN”（用于 cookie 中的 token）或直接依赖 Cookie: XSRF-TOKEN=xxx；但在 web 路由中，更稳妥的方式是显式传递 _token 字段；
• ❌ encodeFormData(eventData) 未定义，应使用 FormData 或 json 格式，并匹配后端期望。

✅ 推荐方案（JSON + 显式 token）：

// 在 home.blade.php 中 const csrfToken = document.head.querySelector('meta[name="csrf-token"]').getAttribute('content'); const eventData = {     title: 'Meeting Room A',     resourceId: 1,     start_date: '2024-06-15',     end_date: '2024-06-15' };  fetch('/api/event/create', {     method: 'POST',     headers: {         'Content-Type': 'application/json',         'X-CSRF-TOKEN': csrfToken // ✅ 正确 header 名称     },     body: JSON.stringify(eventData) }) .then(response => response.json()) .then(data => console.log('Success:', data)) .catch(error => console.error('Error:', error));

? 提示：确保

中已包含 CSRF Meta Tag：

? 总结与注意事项

• 路由方法必须真实存在：检查控制器是否定义了对应方法（如 store），命名需准确，且参数类型提示（Request $request）不可省略；
• CSRF Token 传递要匹配中间件：web 路由需 token，api 路由默认跳过（除非手动加 auth:sanctum 等）；
• 避免日志误导：Request::show does not exist 是框架内部错误回溯，本质是控制器方法未找到或调用链断裂，优先排查路由绑定与方法定义；
• 始终验证输入：生产环境切勿直接 $request->all() 写库，务必白名单过滤（only()）或使用 Form Request；
• 返回结构化响应：便于前端统一处理成功/失败状态，提升调试效率。

完成以上修改后，清除配置缓存（php artisan config:clear）并重试，500 错误将消失，事件数据即可成功写入数据库。