Laravel接口返回首页而非预期响应的问题求助

环境与代码信息 #

UserController 代码 #

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;

class UserController extends Controller
{
    public function index(){
        $users = User::all();
        return $users;
    }

    public function create(Request $request){
        $request->validate([
            'fullname' => 'required|string',
            'gender' => 'required|in:male,female,other',
            'birth_date' => 'required|date',
            'email' => 'required|string|email|unique:users',
            'password' => 'required|string',
        ]);
    
        $user = new User([
            'fullname' => $request->fullname,
            'gender' => $request->gender,
            'birth_date' => $request->birth_date,
            'email' => $request->email,
            'password' => $request->password
        ]);
    
        $user->save();
    
        return response()->json(['message' => 'User created successfully'], 201);
    }
}

api.php 路由配置 #

<?php

use App\Http\Controllers\UserController;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;


Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
    return $request->user();
});

Route::post('/register', [UserController::class, 'create']);

Postman 请求详情 #

• 请求地址：http://localhost:8000/api/register
• 请求方法：POST
• 请求头：Content-Type: application/json
• 请求体：

{
    "fullname": "test",
    "gender": "Male",
    "birth_date": "10-02-1998",
    "email": "test@gmail.com",
    "password": "123456"
}

问题现象 #

发送上述请求后，未收到用户创建成功的响应或验证错误信息，反而返回Laravel项目初始首页。

排查与解决步骤 #

• 确认路由解析与服务器配置：确保网站根目录指向Laravel项目的public文件夹，且服务器（Apache/Nginx）的URL重写规则正确配置，否则路由无法匹配会返回首页。
• 匹配请求方法与路由定义：确认Postman使用POST方法发送请求，与路由中Route::post的定义一致。
• 修正验证规则的大小写问题：请求中gender值为Male，但验证规则限定为male,female,other（全小写），大小写不匹配会触发验证失败。Laravel默认验证失败会重定向，需改为返回JSON错误：
  修改create方法的验证逻辑：

  use Illuminate\Support\Facades\Validator;
  
  // ...
  
  $validator = Validator::make($request->all(), [
      'fullname' => 'required|string',
      'gender' => 'required|in:male,female,other',
      'birth_date' => 'required|date',
      'email' => 'required|string|email|unique:users',
      'password' => 'required|string',
  ]);
  
  if ($validator->fails()) {
      return response()->json($validator->errors(), 400);
  }
  

• 调整日期格式匹配验证规则：Laravel默认date验证期望Y-m-d格式（如1998-02-10），要么修改请求体的birth_date为该格式，要么在验证规则中指定格式：'birth_date' => 'required|date_format:d-m-Y'。
• 检查CSRF保护是否影响API路由：routes/api.php默认不启用CSRF保护，确认app/Http/Kernel.php的api中间件组未包含VerifyCsrfToken，否则会导致POST请求重定向。
• 验证路由存在性：执行终端命令php artisan route:list，确认POST /api/register路由存在且正确指向UserController@create。

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