Laravel Passport授权路由返回格式不一致问题咨询

这是Passport的默认行为，不是你的操作错误。当客户端ID无效时，Passport会抛出OAuthServerException异常，Laravel默认的异常处理逻辑会根据请求的Accept头或请求类型返回JSON；而有效客户端的授权请求则会正常渲染官方的授权视图。

要实现统一的响应格式，这里提供两种可行方案：

方案1：统一返回HTML错误页面 #

• 打开app/Exceptions/Handler.php，在register方法中添加异常捕获逻辑：

use League\OAuth2\Server\Exception\OAuthServerException;

$this->renderable(function (OAuthServerException $e, $request) {
    // 仅针对授权路由处理
    if ($request->is('oauth/authorize')) {
        // 返回自定义错误视图，状态码保持异常的原状态码
        return response()->view('errors.oauth-error', ['message' => $e->getMessage()], $e->getStatusCode());
    }
    // 其他OAuth相关请求仍按默认返回JSON
    return $e->generateHttpResponse(new \Zend\Diactoros\Response());
});

• 在resources/views/errors目录下创建oauth-error.blade.php，自定义错误页面的HTML内容，比如：

<!DOCTYPE html>
<html>
<head>
    <title>授权错误</title>
</head>
<body>
    <h1>授权失败</h1>
    <p>{{ $message }}</p>
</body>
</html>

方案2：根据请求头动态返回JSON或HTML #

这个方案可以让授权请求在Accept头为application/json时统一返回JSON，否则返回HTML：

1. 先处理异常的响应格式，同样在Handler.php的register方法中添加：

use League\OAuth2\Server\Exception\OAuthServerException;

$this->renderable(function (OAuthServerException $e, $request) {
    if ($request->wantsJson()) {
        return response()->json([
            'error' => $e->getMessage(),
            'code' => $e->getCode()
        ], $e->getStatusCode());
    }
    return response()->view('errors.oauth-error', ['message' => $e->getMessage()], $e->getStatusCode());
});

2. 自定义授权控制器，让有效客户端的请求也支持JSON响应：

• 复制Passport的AuthorizeController源码到app/Http/Controllers/OAuth/AuthorizeController.php（可在Passport的vendor目录找到该文件）
• 修改控制器中的authorize方法，在最后判断请求类型：

public function authorize(Request $request)
{
    // 保留原有的客户端验证、权限检查等逻辑...
    
    // 新增：根据请求头判断返回格式
    if ($request->wantsJson()) {
        return response()->json([
            'client_name' => $client->name,
            'scopes' => $scopes->pluck('name')->toArray(),
            'request' => $request->all()
        ]);
    }

    return view('passport.authorizations.authorize', compact('client', 'scopes', 'request'));
}

3. 在routes/web.php中覆盖Passport的默认授权路由：

use App\Http\Controllers\OAuth\AuthorizeController;

Route::get('/oauth/authorize', [AuthorizeController::class, 'authorize'])->middleware(['auth', 'web']);

注意事项 #

• 自定义异常处理器时，不要全局修改OAuthServerException的响应，只针对oauth/authorize路由处理，避免影响Passport的其他API接口（比如令牌获取接口）
• 如果使用方案2，确保前端请求时正确设置Accept头，才能触发对应的响应格式

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