Vapor 仅支持 Laravel 8.0+ 应用，不兼容纯 PHP、其他框架或 Lumen；需遵循其无服务器约定：通过 Artisan 启动、注入环境变量、使用无服务器友好驱动，并正确配置 vapor.yml。
PHP 项目根本不能直接部署到 Vapor 上
不是配置不对，是理解错了 Vapor 的定位：它不是“把现有 PHP 应用扔上去就能跑”的平台。Vapor 是 Laravel 官方的无服务器部署工具，只支持 Laravel 应用（且必须是 8.0+），并且要求项目结构、启动方式、生命周期都符合其约定。纯 PHP 脚本、非 Laravel 的框架（如 CodeIgniter、Slim）、甚至 Laravel Lumen 都不被官方支持——Lumen 缺少 Vapor 所需的 bootstrap/app.php 入口和事件调度机制，会直接报 Call to undefined method Laravel\Lumen\Application::shouldSkipMiddleware()。
Vapor 要求 Laravel 必须使用 Artisan 命令启动 HTTP 服务
Vapor 不运行 php -S 或 Nginx + PHP-FPM，而是把每个 HTTP 请求转为 Lambda 事件，由 Vapor 运行时调用 artisan serve 的封装逻辑来处理。这意味着：
-
.env文件在部署时必须通过 Vapor CLI 注入（vapor env:push production），不能靠 Git 提交；否则 Lambda 环境里读不到配置，常见报错是Database connection [mysql] not configured - 所有请求生命周期必须走 Laravel 内核，不能在
public/index.php里写裸echo或提前exit，否则会中断 Vapor 的响应包装，返回空 200 或超时 - Session、File、Redis 等驱动必须切换为无服务器友好型：
SESSION_DRIVER=cookie、CACHE_DRIVER=dynamodb或redis（需配 ElasticCache）、QUEUE_CONNECTION=sqs—— 默认的file或database在 Lambda 临时文件系统里不可靠
部署失败最常见的三个 vapor deploy 报错及对策
执行 vapor deploy production 卡住或报错，90% 出在本地环境与 AWS 权限/配置不一致：
-
Failed to create CloudFormation stack: InsufficientCapabilitiesException→ 说明你用了 IAM 角色但没在vapor.yml里声明capabilities: [CAPABILITY_IAM] -
PHP Fatal error: Uncaught Error: Class 'PDO' not found→ Laravel Vapor 默认只启用curl、json、mbstring扩展，PDO 需手动在vapor.yml中加extensions: [pdo, pdo_mysql] -
Timeout waiting for Lambda response (15s)→ 不是代码慢，是未设置timeout: 30（单位秒）在vapor.yml的environments.production下；Lambda 默认只有 6 秒，Laravel 启动+路由解析很容易超
本地开发无法模拟 Vapor 的冷启动行为
vapor local 只是用 Docker 模拟 API Gateway + Lambda 的网络转发，并不模拟真实的 Lambda 初始化过程。真正的冷启动会触发完整的 bootstrap/app.php 加载、服务提供者注册、配置合并，耗时可能达 800ms–2s。这就导致：
立即学习“PHP免费学习笔记（深入）”；
- 你在本地测得
config('app.name')正常，但上线后首次请求报Undefined index: app，因为config/app.php被某些条件判断跳过加载了 - 依赖全局函数（如
env()）的地方，在 Lambda 中可能返回null，因为.env没生效，必须改用config()或$_ENV - 自定义 Artisan 命令如果用了
App::environment('local')判断，上线后永远走不到分支——Lambda 环境变量里APP_ENV是production，但vapor local默认设为local
真正验证，只能上 staging 环境跑一次真实请求，看 CloudWatch Logs 里的 START 和 END 时间戳差值。
