Laravel 10 中第三方登录不应使用 Passport，而应使用 Socialite；Passport 是为构建 OAuth2 服务端设计的，第三方登录需作为客户端，Socialite 才是官方推荐方案。
直接说结论：Laravel 10 中用 Passport 搭第三方登录，**不是推荐做法**。Passport 是为构建自己的 OAuth2 服务端（即“你作为授权方”）设计的，比如让其他 App 调用你的 API；而第三方登录（如用微信、Google 登录你的 Laravel 站点）属于“你作为客户端”，应使用 Socialite。
为什么 Passport 不适合做第三方登录
Passport 的核心角色是「颁发令牌」——它让你的应用成为 OAuth2 授权服务器（Authorization Server），别人来向你申请 access_token。但第三方登录时，你是去请求 Google、微信等平台的 token，你是客户端（Client），不是服务端。
强行用 Passport 实现第三方登录，需要手动处理整个 OAuth2 授权码流程（重定向、交换 code、调用 token 接口、解析用户信息），失去封装优势，还容易出安全或兼容问题。
正确方案：用 Socialite + 对应平台
Socialite 是 Laravel 官方推荐、社区广泛验证的第三方登录解决方案，专为「你作为客户端」场景打造，支持 Google、GitHub、Facebook、Microsoft、GitLab 等主流平台，也支持自定义驱动（如微信公众号/小程序需额外适配）。
关键步骤如下：
- 安装：
composer require laravel/socialite - 在
config/services.php中配置平台凭证，例如：'google' => [ 'client_id' => env('GOOGLE_CLIENT_ID'), 'client_secret' => env('GOOGLE_CLIENT_SECRET'), 'redirect' => env('GOOGLE_REDIRECT_URI', 'http://localhost:8000/auth/google/callback'), ] - 在
.env中填入从 Google Cloud Console 获取的GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET和回调地址（必须与控制台完全一致） - 定义路由：
Route::get('/auth/google', [AuthController::class, 'redirectToGoogle']); Route::get('/auth/google/callback', [AuthController::class, 'handleGoogleCallback']); - 在
AuthController中实现两个方法：-
redirectToGoogle()：调用Socialite::driver('google')->redirect()跳转授权页 -
handleGoogleCallback()：接收回调，用Socialite::driver('google')->user()获取用户信息（含 ID、昵称、邮箱等），再查库登录或创建新用户
-
微信等国内平台要特别注意
微信开放平台（网页授权）不被 Socialite 原生支持，但可轻松扩展：
- 用
socialiteproviders/wechat第三方扩展包（维护活跃，适配 Laravel 10） - 或手动实现：按微信文档拼接 authorization URL → 接收 code → 请求
https://api.weixin.qq.com/sns/oauth2/access_token→ 再请求/sns/userinfo获取用户信息 - 关键点：微信返回的 openid 是唯一标识，不能直接当邮箱用；首次登录需引导补全手机号或生成虚拟邮箱（如
openid_xxx@wx.local），确保 User 模型字段合规
如果真要用 Passport —— 只有一种合理场景
当你的 Laravel 应用本身要对外提供 API，并且希望「其他前端项目（如 Vue SPA、小程序）也能用微信/Google 登录后访问你的 API」时，可组合使用：
- 前端用 Socialite 流程完成第三方登录，拿到用户信息
- 前端把用户标识（如 email 或 openid）提交给你的 Laravel 后端
- 后端用该标识查找或创建用户，再通过
Passport::tokenResponse()或$user->createToken()发放个人访问令牌（Personal Access Token） - 后续 API 请求携带此 token，由 Passport 中间件验证
这本质是「Socialite 做身份认证，Passport 做 API 授权」，二者分工明确，不是用 Passport 替代 Socialite。
