Docker环境下Laravel迁移dropColumn()报错连接拒绝问题排查

• 数据库连接超时设置过短
  执行DROP COLUMN的ALTER TABLE操作如果涉及数据量较大的表，耗时可能比普通读写操作更长，若MariaDB的wait_timeout或interactive_timeout设置过低，会导致连接被主动断开。
  排查步骤：

  1. 进入MariaDB容器：docker-compose exec mariadb mysql -uroot -proot
  2. 查看超时配置：SHOW VARIABLES LIKE '%timeout%';
  3. 若wait_timeout或interactive_timeout小于300秒，可临时调整：SET GLOBAL wait_timeout=300; SET GLOBAL interactive_timeout=300;，也可以在docker-compose的mariadb服务中添加command参数永久设置：

     mariadb:
       # 原有配置
       command: --wait_timeout=300 --interactive_timeout=300
     

• Docker容器网络或服务稳定性问题
  虽然日常读写操作正常，但MariaDB容器可能在迁移执行时出现临时重启或网络波动，导致连接拒绝。
  排查步骤：

  1. 检查容器状态：docker-compose ps mariadb，确认状态为Up
  2. 查看容器日志：docker-compose logs mariadb，排查是否有启动失败、崩溃或连接异常的日志
  3. 在应用容器内直接测试数据库连接：docker-compose exec [你的应用容器名] mysql -hmariadb -uroot -proot project，确认连接是否稳定

• Doctrine DBAL版本兼容问题
  已安装doctrine/dbal，但版本与当前Laravel版本不匹配，可能导致字段删除逻辑出错，间接引发连接异常。
  排查步骤：

  1. 查看composer.json中的doctrine/dbal版本，对照Laravel官方文档确认兼容版本（比如Laravel 10要求^3.6，Laravel 9要求^3.0）
  2. 若版本不匹配，调整后执行composer update doctrine/dbal

• 表锁或阻塞进程
  若之前的数据库操作未释放表锁，或存在长时间运行的阻塞进程，会导致ALTER TABLE操作卡住，最终触发连接超时拒绝。
  排查步骤：

  1. 进入MariaDB执行：SHOW PROCESSLIST;，查看是否有State为Waiting for table metadata lock或其他阻塞状态的进程
  2. 查看锁表情况：SHOW OPEN TABLES WHERE In_use > 0;
  3. 若存在阻塞进程，可根据Id字段执行KILL [进程ID];（注意：需确认进程无业务影响）

• Laravel配置缓存问题
  若之前执行过php artisan config:cache，可能缓存了旧的数据库配置，导致实际连接地址错误。
  解决步骤：
  执行php artisan config:clear清除配置缓存，再重新运行迁移：php artisan migrate

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