Vapor部署报“Class 'PDO' not found”是因为其Lambda环境默认仅启用curl、json、mbstring扩展，未启用pdo及对应驱动（如pdo_mysql），需在vapor.yml中显式声明extensions: [pdo, pdo_mysql]。
不能把普通 PHP 项目或非 Laravel 8+ 应用直接扔进 Vapor 部署——不是配置问题，是 Vapor 根本不认它。
为什么 vapor deploy 报错 “Class 'PDO' not found”
这是 Vapor 默认 PHP 运行时禁用了 PDO 扩展导致的。Laravel 连数据库、执行迁移、读取配置都依赖 PDO，但 Vapor 的 Lambda 环境只预装 curl、json、mbstring 这几个扩展。
必须手动在 vapor.yml 中声明：
environments:
production:
runtime: php82
extensions:
- pdo
- pdo_mysql
- mysqli
漏掉 mysqli 会导致某些 DB 驱动（比如使用 mysql 方式连接）失败；pdo_pgsql 或 pdo_sqlite 要按实际数据库类型加。
- 只加
pdo不加具体驱动，照样报错 - PHP 版本升级到 8.2 后，
mysql扩展已移除，必须用mysqli或pdo_mysql -
vapor build本地构建时不会报这个错，只有部署后首次请求才暴露——因为构建不校验扩展可用性
部署后所有未登录用户都被限流：IP 是空的
Vapor 下 $request->ip() 返回空字符串，导致 Laravel 默认节流中间件生成的签名恒为 sha1('|')，所有游客共享同一个限流桶。
根本原因是 API Gateway 在转发请求时没透传真实客户端 IP，而是给了 Lambda 一个内部网关地址（如 127.0.0.1 或空值）。
修复方式不是改中间件逻辑，而是覆盖 Laravel 的 IP 解析行为：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 在
App\Http\Middleware\TrustProxies中补全$headers映射：protected $headers = Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO; - 确保
APP_URL和TRUSTED_PROXIES在vapor.yml中设为*或明确列出 API Gateway 的 CIDR 段（如10.0.0.0/8） - 不要依赖
$_SERVER['REMOTE_ADDR']，Vapor 运行时根本不设这个
验证是否生效：写个路由 Route::get('/debug/ip', fn() => request()->ip());，部署后访问看返回值。
vapor deploy 卡在 “Ensuring Http API Is Configured”
这个阶段失败，90% 是 SSL 证书权限或区域错配。Vapor 默认用 us-east-1 创建 ACM 证书，但如果你的域名证书是在其他区域申请的（比如 us-west-2），就会报错 The certificate provided must be owned by the account creating the domain。
关键点：
- Vapor UI 上看到的证书，必须和
vapor.yml中environments.production.domain指向的区域完全一致 - 删除旧证书时，要进 AWS 控制台 → Certificate Manager → 切换到对应区域 → 删除所有状态为
Pending validation或Failed的证书 - 不要复用已有证书 ARN；Vapor 要求证书由当前 IAM 角色“拥有”，跨账号/跨区域导入的证书不被信任
- 如果用了自定义域名，确保 DNS 已解析到 Vapor 分配的
xxx.execute-api.region.amazonaws.com，否则 ACM 验证无法通过
Session 和缓存驱动为什么必须改
Lambda 实例是临时的、无状态的，每次请求可能落在不同容器里。用默认的 file 或 database 驱动，等于把 Session 存在随时会被清空的内存或本地磁盘上。
必须显式切换：
-
SESSION_DRIVER=cookie：最轻量，适合无敏感数据的场景；注意加密密钥APP_KEY必须稳定，不能每次部署重生成 -
CACHE_DRIVER=dynamodb：Vapor 原生支持，自动建表，适合高频小数据缓存；但单次读写有 1MB 限制 -
QUEUE_CONNECTION=sqs：别用sync或database，否则队列任务只在当前 Lambda 实例内执行，冷启动后丢失 -
REDIS_HOST必须指向 ElasticCache 集群，不能填 localhost 或 Docker 网络地址——Lambda 根本连不到你本地 Redis
最容易被忽略的是：.env 文件里的这些配置，在部署时不会自动生效。必须写进 vapor.yml 的 environments.*.variables 块里，或者用 vapor env:push 单独推送。
