Laravel-admin的admin:install连接超时实为PHP无法连MySQL，主因是MySQL未启动、DB_HOST配置错误（如Docker中误用localhost）、DB_PORT不匹配或防火墙拦截，需通过telnet和DB::connection()->getPdo()验证通路。
连接超时不是 laravel-admin 的问题，而是它在执行 php artisan admin:install 时尝试连数据库失败了——这个命令会跑迁移、插入初始菜单、生成管理员用户，每一步都依赖数据库可用。
为什么 admin:install 会卡在“连接超时”
报错通常类似 SQLSTATE[HY000] [2002] Connection timed out 或 Connection refused。这不是 Laravel 框架或 laravel-admin 包本身的问题，而是 PHP 进程根本连不上 MySQL 服务端。
- MySQL 服务没启动（尤其 Homestead/Vagrant 环境里常被关掉）
-
DB_HOST配错了：比如写成localhost，但在 Docker 或远程部署场景下必须用宿主机 IP 或容器名 -
DB_PORT不是 3306：MAMP、XAMPP、Docker 镜像经常改端口，sudo netstat -tuln | grep :3306才能确认真实监听端口 - 防火墙拦截了从 PHP 进程发起的出站连接（少见但存在，尤其 Windows WSL2 + Ubuntu + ufw 组合）
怎么快速验证是不是防火墙拦的
别猜，直接测通路。在运行 admin:install 的同一台机器上执行：
- 先测本地回环：
telnet 127.0.0.1 $DB_PORT（把$DB_PORT换成你 .env 里的值）。通 → 说明 MySQL 活着且监听本机；不通 → MySQL 没启或没监听 127.0.0.1 - 再测目标地址：
telnet $DB_HOST $DB_PORT。不通但上一步通 → 很可能是防火墙或网络路由问题 - Linux 上查本机防火墙：
sudo ufw status verbose或sudo iptables -L INPUT -n，看有没有 DROP 规则挡了该端口 - Windows 用户重点检查 WSL2 的
firewall.exe规则，或 Hyper-V 虚拟交换机设置
laravel-admin 安装阶段最容易漏的三件事
即使数据库连上了，admin:install 仍可能失败，因为它的安装逻辑对环境很敏感：
-
APP_URL必须带协议和域名，不能是http://localhost却用127.0.0.1访问，否则 session 域名不匹配，后续登录跳转会反复重定向 - 如果数据库字符集是 utf8mb4，但没设
Schema::defaultStringLength(191)，迁移会因索引过长报Specified key was too long -
public/vendor/laravel-admin目录为空？说明资源没发布成功，补跑：php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"
真正卡住的点，往往不在 laravel-admin 代码里，而在 DB_HOST 解析、MySQL 权限、或系统级网络策略上。先让 php artisan tinker 里执行 DB::connection()->getPdo() 不报错，再跑 install —— 否则所有日志和调试都是在修幻影 Bug。
