Laravel 8如何限制数据库连接数解决max_user_connections报错

完全可以通过框架侧配置将数据库连接占用控制在共享主机的5个上限以内，无需升级VPS，具体可落地的调整项如下：

• 关闭数据库持久连接
  持久连接会导致请求结束后连接不释放，长期占用连接额度，直接修改config/database.php中对应数据库连接的配置：

  'mysql' => [
      // 其余原有配置保留
      'persistent' => false,
  ]
  

  配置修改后执行php artisan config:cache生效。
• 替换数据库类型的驱动，减少无效连接占用
  默认如果把缓存、会话、队列存储在MySQL中，会额外产生连接占用，直接修改.env配置，将这三类驱动改为无额外数据库连接的模式：

  CACHE_DRIVER=file
  SESSION_DRIVER=file
  # 站点流量不大时直接用同步队列，无需启动长驻队列进程
  QUEUE_CONNECTION=sync
  

• 控制长驻进程的连接占用
  如果必须使用异步队列，启动worker进程时数量严格控制在2个以内，同时在app/Providers/AppServiceProvider.php的boot方法中添加回调，在任务执行完成后主动释放数据库连接，避免长驻进程长期占用连接不释放：

  use Illuminate\Support\Facades\DB;
  use Illuminate\Support\Facades\Queue;
  use Illuminate\Queue\Events\JobProcessed;
  
  public function boot()
  {
      Queue::after(function (JobProcessed $event) {
          DB::disconnect();
      });
  }
  

  定时任务、tinker等临时脚本执行完成后会自动退出释放连接，只要不要同时启动超过3个长驻进程，就不会占满连接额度。
• 规范数据库连接调用逻辑
  所有数据库操作统一走Eloquent ORM或者DB门面，非特殊场景不要手动调用DB::purge()、DB::disconnect()主动断开连接，避免框架自动重连产生额外连接；不要在业务代码里手动新建PDO实例连接数据库，所有连接走框架的连接管理器复用，保证单次web请求全程只占用1个数据库连接。

按以上配置调整后，站点正常运行的峰值连接数会稳定在2-3个，完全低于共享主机设置的5个上限，不会再触发User **** already has more than 'max_user_connections' active connections报错。

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