You need to enable JavaScript to run this app. Laravel Vapor部署项目无法连接Vapor数据库 报SQLSTATE[HY000][2002]错误
优惠活动
大模型
产品
解决方案
定价
更多

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 * from images limit 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 10:15:10