部署Laravel应用至Digital Ocean App时遇部署阶段数据库连接超时

问题定位 #

应用运行正常但构建时超时，说明构建环境与运行环境的数据库访问逻辑存在差异，核心是dump-autoload过程中意外触发了数据库连接，而构建环境无法访问目标数据库。

解决方案 #

• 临时替换构建环境的数据库驱动
  构建阶段不需要真实数据库，通过环境变量强制使用无依赖驱动：

  # 执行composer命令前设置
  APP_ENV=build DB_CONNECTION=sqlite DB_DATABASE=:memory: composer dump-autoload --optimize --no-dev
  

  也可以在config/database.php中为build环境单独配置内存型SQLite，避免硬编码环境变量。

• 阻止服务提供者在构建阶段触发数据库操作
  检查数据库翻译相关的服务提供者，将数据库依赖逻辑限制在运行环境执行：

  public function boot()
  {
      // 仅在非控制台构建环境加载数据库翻译
      if ($this->app->runningInConsole() && !$this->app->isRunningUnitTests()) {
          return;
      }
      $this->loadDatabaseTranslations();
  }
  

  避免在register方法、类静态初始化块中执行数据库查询，这类代码会在autoload时被自动执行。

• 调整Composer autoload优化策略
  关闭类映射权威模式，避免Composer预加载触发不必要的类初始化：

  {
      "config": {
          "classmap-authoritative": false,
          "optimize-autoloader": true
      }
  }
  

  执行dump-autoload时添加--no-dev排除开发依赖，减少潜在的数据库触发点。

• 排查构建环境网络权限
  如果必须在构建阶段连接数据库：

  • 用nc -zv <db-host> <db-port>测试构建服务器到数据库的连通性
  • 检查数据库防火墙/安全组是否开放构建环境IP的访问权限
  • 云数据库需确认公网访问开关已开启（构建环境通常不在内网）

内容的提问来源于stack exchange，提问作者Adelin