Laravel Vapor部署项目无法连接Vapor数据库 报SQLSTATE[HY000][2002]错误
Laravel Vapor 数据库连接 2002 报错解决方案
问题基础信息
- 复现范围:所有部署在Vapor上的Laravel项目访问带数据库查询的接口时,均触发
SQLSTATE[HY000] [2002]连接错误 - 已完成的排除项:新建空白测试项目与目标数据库部署在同一AWS区域,排除跨区域访问异常;Vapor控制台显示项目已成功关联
vapor-db数据库;删除本地.env中默认数据库配置后报错仍存在 - 测试复现路径:访问预发环境的
dbtest测试路由,返回结构化报错:Illuminate\Database\QueryException SQLSTATE[HY000] [2002] (SQL: select * fromimageslimit 1)
已完成的部署配置
- 通过Composer安装Vapor CLI与Core组件
- 在
vapor.yml中添加生产、预发环境的数据库关联配置 - 新增
dbtest测试路由用于直连查询数据库 - 开启
APP_DEBUG获取详细报错信息
vapor.yml 配置内容
id: 17458 name: laravel82 environments: production: database: vapor-db memory: 1024 cli-memory: 512 runtime: php-7.4 build: - 'COMPOSER_MIRROR_PATH_REPOS=1 composer install --no-dev' - 'php artisan event:cache' - 'npm ci && npm run prod && rm -rf node_modules' staging: database: vapor-db memory: 1024 cli-memory: 512 runtime: php-7.4 build: - 'COMPOSER_MIRROR_PATH_REPOS=1 composer install' - 'php artisan event:cache' - 'npm ci && npm run dev && rm -rf node_modules'
Web 路由测试配置
Route::get('/', function () { return view('welcome'); }); Route::get('dbtest', function () { return \DB::table('images')->first(); });
可落地排查步骤与修复方案
- 检查安全组授权同步状态
2002报错本质是网络层无法建立与数据库的TCP连接。进入Vapor控制台的数据库详情页,确认对应环境的Lambda函数是否被纳入数据库的允许访问列表。若关联状态显示正常但连接失败,可手动解除数据库关联后重新绑定,触发安全组规则自动同步。 - 清理部署包内的旧配置缓存
若本地曾执行php artisan config:cache,生成的配置缓存文件会被打包到部署产物中,覆盖Vapor运行时自动注入的数据库连接环境变量。本地执行php artisan config:clear清空缓存后重新触发全量部署,确保无旧配置残留。 - 验证运行时数据库驱动完整性
当前配置使用php-7.4运行时,需确认对应版本的Vapor PHP镜像是否预装pdo_mysql扩展。可临时在测试路由中输出extension_loaded('pdo_mysql')的返回值,若返回false则需升级runtime至当前稳定兼容版本,或在Vapor配置中手动开启对应数据库扩展。 - 核对数据库实例状态
进入对应云平台的数据库控制台,检查vapor-db实例是否处于正常可用状态,确认VPC路由配置、安全组规则是否放行Lambda到数据库3306端口的流量。
注意:Vapor自动注入的数据库连接参数,仅会在关联数据库完成后的下一次全量部署中生效,关联操作完成后不能直接复用现有实例的旧运行时环境,必须重新部署一次才能拿到正确的连接参数。
内容的提问来源于stack exchange,提问作者Holly
相关产品推荐
相关产品推荐

