直接安装 oauth2-server 失败主因是 php 版本不匹配：v8.0+ 要求 php ≥ 8.0，旧版需降级；授权失败常因 redirect_uri、response_type、scope 或 pkce 参数不精确匹配。
直接安装 oauth2-server 库会失败？先确认 PHP 和 Composer 版本
Composer 安装 league/oauth2-server 失败，大概率不是库本身的问题，而是环境不匹配。这个库从 v8.0 开始要求 PHP ≥ 8.0，而很多项目还在用 PHP 7.4 或 7.3 —— 此时强行运行 composer require league/oauth2-server 会报错：Your requirements could not be resolved to an installable set of packages.
解决办法很直接：
- 用
php -v确认当前 CLI 的 PHP 版本（注意：CLI 版本可能和 Web 服务器不同） - 查清你要对接的框架或已有项目实际运行的 PHP 版本
- 如果 PHP composer require league/oauth2-server:^7.4（支持 PHP 7.2+）
- 别忽略
ext-sodium扩展——v7.x 起默认依赖它做加密，PHP 7.2+ 自带，但某些 Docker 镜像或旧系统需手动启用
为什么 require league/oauth2-server 后不能直接跑起来？你漏了存储层实现
league/oauth2-server 是个“骨架”，它不自带数据库表或 Redis 连接逻辑，所有持久化操作都靠你传入的实现类。不写存储适配器，调用 AuthorizationServer 构造函数时就会报错：Argument 2 passed to League\OAuth2\Server\AuthorizationServer::__construct() must be an instance of League\OAuth2\Server\Repositories\ClientRepositoryInterface
你需要自己实现至少 4 个接口：
-
ClientRepositoryInterface：查 client_id/client_secret，判断是否有效、是否允许授权码模式 -
AccessTokenRepositoryInterface：存取 access_token（含 scope、user_id、过期时间） -
RefreshTokenRepositoryInterface：刷新 token 时用，通常和 access_token 关联 -
ScopeRepositoryInterface：校验请求的 scope 是否被 client 允许（比如read:profile write:post）
别抄网上“空实现”示例——哪怕只用内存数组模拟，也得返回符合接口签名的对象（例如 getById() 必须返回 ClientEntityInterface 实例，不能 return null）。
AuthorizationServer 构造时传错加密密钥？常见 PEM 格式陷阱
初始化 AuthorizationServer 时第 3、4 个参数是私钥和公钥，类型必须是 EncryptionKey 实例，不是字符串路径。很多人直接传 'file://keys/private.key' 导致报错：League\OAuth2\Server\Exception\OAuthServerException: The key length is invalid.
正确做法：
- 生成密钥对：用
openssl genrsa -out private.key 2048和openssl rsa -in private.key -pubout -out public.key - 读取内容并封装：
new \League\OAuth2\Server\CryptKey('file://'.__DIR__.'/private.key', 'passphrase-if-set', true) - 第三个参数
true表示“强制从文件加载”，否则库会尝试 base64 解码字符串内容 - public.key 必须是 PEM 格式（以
-----BEGIN PUBLIC KEY-----开头），不能是 DER 或 JWK
handleAuthorizeRequest() 返回 401 而不是跳转？检查 response_type 和 redirect_uri 是否严格匹配
调用 $server->handleAuthorizeRequest($request) 后没重定向，反而返回 JSON 错误或 401，往往是因为授权请求参数不合规。OAuth 2.0 对 response_type 和 redirect_uri 的校验是精确匹配（包括末尾斜杠、协议大小写、query 参数顺序）。
典型问题：
- 注册 client 时填的
redirect_uri是https://example.com/callback，但请求里传的是https://example.com/callback/（多了一个斜杠）→ 直接拒绝 -
response_type=code写成response_type=CODE→ 不识别 - 没传
scope，但 client 在数据库里配置了 required_scope → 拒绝 - 使用 PKCE 时漏了
code_challenge和code_challenge_method→ 即使 client 允许 PKCE 也会失败
调试建议：在 ClientRepository::validateRedirectUri() 里加日志，把数据库存的值和请求里的值逐字符对比。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
