admin:install卡在数据库连接阶段本质是Laravel数据库配置错误：DB_HOST应为127.0.0.1（非localhost）、Docker环境须填容器名；需先用DB::connection()->getPdo()验证连通性，再检查config/admin.php中'connection'是否匹配config/database.php定义的连接名，并在AppServiceProvider::boot()中添加Schema::defaultStringLength(191)解决MySQL 5.6/5.7的1071索引超长问题。
admin:install卡在数据库连接阶段
根本不是 laravel-admin 本身的问题，而是 php artisan admin:install 命令执行时依赖 Laravel 的默认数据库连接，它会立刻尝试建表、插入初始用户——如果 DB_CONNECTION 配置无效或凭据错误，命令就会卡住或直接报错 SQLSTATE[HY000] [1045] Access denied。
实操建议：
- 先验证 Laravel 自身能否连库：运行
php artisan tinker，然后输入DB::connection()->getPdo()，能返回 PDO 实例才算通；如果报错，说明.env里的DB_HOST、DB_PORT、DB_USERNAME、DB_PASSWORD或DB_DATABASE有误 - 特别注意
DB_HOST：本地开发别写localhost，改用127.0.0.1（MySQL 8+ 对 localhost 有 socket 特殊处理，容易拒连） - Docker 环境下，
DB_HOST必须填容器服务名（如db），不能填127.0.0.1或localhost，否则连的是 PHP 容器本机而非 MySQL 容器
用了非默认数据库连接名（比如 legacy_db）
admin:install 默认只认 mysql 连接，哪怕你在 config/database.php 里新增了 legacy_db，不显式告诉 laravel-admin，它照样去连 mysql 并失败。
实操建议：
- 打开
config/admin.php，找到'database'配置段，在里面加一行：'connection' => 'legacy_db' - 确保该连接名已在
config/database.php的'connections'数组中正确定义 - 不要试图在
.env中覆盖DB_CONNECTION来“欺骗”安装命令——它只读配置文件，不读环境变量的动态值
MySQL 5.6/5.7 报错 1071 Specified key was too long
这是老版本 MySQL 的索引长度限制问题，laravel-admin 的迁移文件里有些字段（比如 email）用了 utf8mb4 字符集 + unique 约束，导致索引超长。错误信息通常是 SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long。
实操建议：
- 在
app/Providers/AppServiceProvider.php的boot()方法里加一行：Schema::defaultStringLength(191) - 确保已引入命名空间：
use Illuminate\Support\Facades\Schema; - 如果项目已启用
APP_DEBUG=false，记得清缓存：php artisan config:clear && php artisan cache:clear，否则修改不生效
安装后登录 403 或进不去 /admin
不是密码错，也不是路由没加载，而是 Laravel 的认证守卫（guard）和提供者（provider）没对齐——laravel-admin 默认用 admin guard，但如果你改过 config/auth.php 里的 'defaults.guard' 或删过 'guards.admin' 配置，登录中间件就找不到对应逻辑。
实操建议：
- 检查
config/auth.php是否还保留完整的'guards.admin'和'providers.admins'配置块 - 确认
config/admin.php中的'auth' => ['guards' => ['admin']]没被注释或误删 - 如果之前手动改过
AuthServiceProvider或自定义过中间件，回退到 laravel-admin 自动生成的版本再试
最常被忽略的是：admin:install 成功只代表表建好了、初始用户插进去了，但后续所有权限、菜单、路由都依赖 config/admin.php 和 config/auth.php 的结构完整——缺一个键，后台就可能半瘫痪。
