Laravel POST/PUT请求自动重定向至默认页面问题求助

问题现象 #

• POST请求部分路由时，Laravel返回默认页面，dump语句能正常输出但末尾附带首页重定向链接
• PUT请求同样失效，仅GET路由可正常响应

相关代码 #

路由定义 #

Route::group(['middleware'=> 'admin'], function () {

// User
Route::get('/users', 'App\Http\Controllers\UserController@index');
Route::apiResource('/user', 'App\Http\Controllers\UserController')->only(['store', 'destroy']);

});

UserController的store方法 #

public function store(Request $request, UserSSHKeyService $sshKey, ApiTokenService $apiToken)
{
    $data = $this->dataRequest($request);

    // 检查邮箱是否已存在
    $userAlreadyExists = User::where('email', $data['email'])->exists();

    if ($userAlreadyExists)
        return response()->json(['error' => '该邮箱地址已存在'], 500);
    
    $user = new User();
    $user->name = $data['name'];
    $user->email = $data['email'];
    $user->password = Hash::make($data['password']);

    // 若存在admin字段
    if(isset($data['admin']))
        $user->admin = $data['admin'];

    try {
        $user->save();
    } catch (\Exception $e) {
        return response()->json(['error save user' => $e->getMessage()], 500);
    }

    // 同步用户与组的关联
    try {
        $user->groupUser()->sync($data['groups']);
    }   catch (\Exception $e) {
        return response()->json(['error sync user' => $e->getMessage()], 500);
    }

    // 若存在则创建SSH密钥
    if (isset($data['sshName'])) {
        try {
            $sshKey->saveUserSSHKey($data['sshName'], $data['sshCtm'], $data['sshExpire'], $data['sshPublicKey'], $user);
        } catch (\Exception $e) {
            return response()->json(['error save SSH key user' => $e->getMessage()], 500);
        }

    }

    // 若存在则创建API令牌
    if (isset($data['tokenName'])) {
        try {
            $apiToken->saveApiTokenUser($data['tokenName'], $data['tokenCtm'], $data['tokenExpire'], $data['token'], $user);
        } catch (\Exception $e) {
            return response()->json(['error save SSH key user' => $e->getMessage()], 500);
        }
    }
    

    return response()->json($user) ;
}

UserController的dataRequest私有方法 #

private function dataRequest($request)
{
    return $request->validate([
            'name' => 'required|string',
            'email' => 'required|string',
            'password' => 'required|string',
            'groups' => 'required|array',
            'groups. *' => 'required|exists:group,id',
            'admin' => 'nullable|boolean',
            'sshName' => 'nullable|string',
            'sshCtm' => 'nullable|date',
            'sshExpire' => 'nullable|date',
            'sshPublicKey' => 'nullable|string',
            'tokenName' => 'nullable|string',
            'tokenCtm' => 'nullable|date',
            'tokenExpire' => 'nullable|date',
            'token' => 'nullable|date',
        ]);
}

Admin中间件 #

public function handle(Request $request, Closure $next): Response
{
    if (auth()->check() && auth()->user()->admin) {
        return $next($request);
    }

    abort(403, 'Unauthorized action');
}

排查与解决方法 #

1. 修正请求头配置
   API请求必须携带Accept: application/json请求头，否则Laravel会默认返回HTML页面（包括验证失败时的重定向）。在Postman中检查并添加该请求头。

2. 修复表单验证的默认行为
   $request->validate()在验证失败时，默认会重定向到上一页（针对Web场景），但API请求需要返回JSON错误。修改dataRequest方法，手动使用Validator类处理验证：

   private function dataRequest($request)
   {
       $validator = Validator::make($request->all(), [
           'name' => 'required|string',
           'email' => 'required|string',
           'password' => 'required|string',
           'groups' => 'required|array',
           'groups.*' => 'required|exists:group,id', // 移除原规则中的空格，否则数组元素验证失效
           'admin' => 'nullable|boolean',
           'sshName' => 'nullable|string',
           'sshCtm' => 'nullable|date',
           'sshExpire' => 'nullable|date',
           'sshPublicKey' => 'nullable|string',
           'tokenName' => 'nullable|string',
           'tokenCtm' => 'nullable|date',
           'tokenExpire' => 'nullable|date',
           'token' => 'nullable|string', // 原规则中token设为date类型错误，令牌应为字符串
       ]);
   
       if ($validator->fails()) {
           return response()->json(['errors' => $validator->errors()], 422);
       }
   
       return $validator->validated();
   }
   

   注意：原代码中groups. *的空格会导致数组元素验证规则失效，token字段的date规则不符合令牌的实际类型，这两处错误会引发验证失败，进而触发默认重定向。

3. 确认路由文件位置
   确保API路由定义在routes/api.php中，而非routes/web.php。web.php中的路由默认包含Session、CSRF等中间件，会干扰API请求；api.php默认不受CSRF限制，更适合API场景。

4. 排除CSRF中间件影响
   如果路由必须放在web.php，POST/PUT请求需要携带CSRF令牌，否则Laravel会返回419错误并重定向到首页。但API项目建议优先使用api.php路由。

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