Laravel JSON API用Postman POST请求遇405/500错误求助

一、405 Method Not Allowed 问题排查 #

• 核对路由配置：确认routes/api.php中为/api/news配置了POST方法路由，比如Route::post('/news', [NewsController::class, 'store']);，避免仅定义GET路由。
• 清除路由缓存：执行php artisan route:clear，确保新添加的POST路由生效（若之前生成过路由缓存）。
• 检查中间件限制：排查全局或路由组中间件，确认是否有拦截POST请求的规则。

二、500错误（title字段为空）问题排查 #

• 确认请求头设置：Postman中必须添加Content-Type: application/json请求头，Laravel仅解析带该头的JSON payload，否则参数会被忽略。
• 检查请求格式：Postman的Body选项卡需选择raw并设置格式为JSON，不要用form-data或x-www-form-urlencoded，否则JSON无法被正确解析。
• 查看Laravel日志：打开storage/logs/laravel.log，查看500错误的详细堆栈信息，排查是否存在模型填充、数据库字段定义等隐藏问题。
• 验证模型填充属性：确保News模型中设置了protected $fillable = ['title', ...];，否则Laravel无法批量赋值，导致字段为空。

三、额外验证步骤 #

• 打印请求参数：在控制器store方法开头添加dd($request->all());，查看Laravel实际接收的参数是否为空，判断是请求发送还是后端处理问题。
• 简化请求测试：用极简JSON payload（如{"title": "测试新闻"}）测试，排除其他字段干扰。

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