laravel-admin安装失败90%因php artisan admin:install卡住，主因是环境或数据库未就绪：需确保Laravel环境正常、DB_DATABASE指向已存在且可写的空库、MySQL≥5.7.7时在AppServiceProvider中添加Schema::defaultStringLength(191)。
直接上结论：laravel-admin 安装失败，90% 是卡在 php artisan admin:install 这一步——不是代码写错，而是环境或数据库准备没到位。只要按顺序检查这三件事，基本一次过。
确认 Laravel 环境和数据库已就绪
laravel-admin 不是独立应用，它强依赖 Laravel 底层运行环境和可用数据库连接。跳过这步硬装，后面全会报错。
-
.env中的DB_DATABASE必须指向一个**已存在且可写的空库**（不是只创建了库名，还要确保用户有 CREATE/ALTER 权限） - PHP 版本需 ≥ 7.2.5；Laravel 推荐用 10.x 或 11.x（
encore/laravel-admin当前稳定版兼容到 Laravel 11） - 如果 MySQL 版本 ≥ 5.7.7 且未显式设置字符集长度，
admin:install会因索引长度超限失败。此时要在app/Providers/AppServiceProvider.php的boot()方法里加一行：Schema::defaultStringLength(191);
执行三步命令，顺序不能乱
这是 laravel-admin 的标准包安装流程，也是最容易手抖打错的环节。注意路径、引号、反斜杠全部要严格匹配。
- 安装包：
composer require encore/laravel-admin（不加版本号默认拉最新稳定版；如需锁定 v1.8.x，写成composer require encore/laravel-admin "1.8.*"） - 发布配置与资源：
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"（注意双引号、等号前后无空格） - 初始化数据库和管理员：
php artisan admin:install（此命令会自动建表、插入admin_users记录，用户名密码均为admin）
访问后台前必须检查的两个细节
装完跑不起来？大概率是这两个地方被忽略：
- 路由访问路径默认是
/admin，但实际入口是/admin/auth/login。直接访问/admin会 404，必须带/auth/login - 中文支持需两步：改
config/app.php中的'locale' => 'zh-CN'；左侧菜单文字来自数据库表admin_menu，字段title是手动存的，改语言后要进 phpMyAdmin 或 tinker 手动更新那几条记录
最常被跳过的其实是 admin:install 失败后的清理动作：它一旦中途出错，会在数据库里留半截表（比如只有 admin_users 没有 admin_permissions）。下次再跑命令不会自动重试或回滚，得先清空所有 admin_* 表，或者干脆删库重建。
