如何解决Laravel 5.5中浏览器访问API路由的报错问题？

问题原因 #

当你在浏览器直接访问需要认证的API路由时，由于浏览器没有携带API认证令牌（比如Bearer Token），Laravel的默认认证中间件会尝试将请求重定向到login路由，但你的API路由组里并没有定义这个路由，所以抛出InvalidArgumentException Route [login] not defined错误。

解决方案1：修改未认证请求的处理逻辑（推荐） #

Laravel 5.5的异常处理器里有专门处理未认证请求的方法，我们可以修改它，让API请求返回JSON格式的错误，而不是重定向到login页面：

打开app/Exceptions/Handler.php，找到unauthenticated方法（如果没有就添加），替换成下面的代码：

protected function unauthenticated($request, AuthenticationException $exception)
{
    // 判断是否是API请求
    if ($request->expectsJson()) {
        return response()->json(['error' => 'Unauthenticated.'], 401);
    }

    // 非API请求还是走原来的重定向逻辑
    return redirect()->guest(route('login'));
}

这样一来，当浏览器直接访问API路由时，会返回401 Unauthenticated的JSON响应，而不是报错找不到login路由。

解决方案2：调整API路由的中间件 #

如果你的api/books路由其实不需要认证，那可以把它从auth:api中间件组中移除：
在routes/api.php里，原来的代码可能是这样的：

Route::middleware('auth:api')->group(function () {
    Route::get('/books', 'BookController@index');
});

改成不需要认证的形式：

// 不需要认证的路由放在中间件组外面
Route::get('/books', 'BookController@index');

// 其他需要认证的路由留在中间件组里
Route::middleware('auth:api')->group(function () {
    // ... 其他路由
});

这样任何人都能直接访问api/books，自然不会触发认证跳转。

解决方案3：不处理（不推荐，但可选） #

你提到这类用户占比极低，如果实在不想处理，理论上也可以放任不管，但我还是建议至少做个简单处理——比如返回一个友好的提示页面或者JSON响应，不然用户看到一堆错误信息体验很差，也可能被搜索引擎抓取到错误状态，影响站点的SEO表现。

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