laravel-admin安装失败主因是镜像源未生效或不同步，导致依赖未装全；需验证composer config -g repo.packagist.url、执行clear-cache、删lock与vendor后用--repository-url强制指定腾讯云镜像重装。
laravel-admin 安装失败，八成不是代码问题，而是 composer install 根本没装全依赖——镜像源不可用、不同步或配置被覆盖，导致 vendor/autoload.php 存在但类找不到。
为什么 laravel-admin 安装卡在 Class not found 或 vendor/autoload.php 加载失败
这不是 autoloader 机制坏了，而是依赖压根没下全。典型表现：vendor/autoload.php 文件存在、能 require，但一 new 某个类就报 Class 'Encore\Admin\AdminServiceProvider' not found。
- 镜像源未同步：比如阿里云镜像延迟 5–10 分钟，腾讯云相对及时；若你刚切源就跑
composer install，可能拉到的是旧元数据 - 项目级
repositories字段存在且禁用了 packagist（如"packagist": false），会彻底屏蔽全局镜像设置 -
composer.lock里记录的是官方源的哈希，换源后不删 lock 直接 install，Composer 仍尝试从 packagist.org 验证包，结果超时或 404 - 全局配置写入失败：Windows 下
%APPDATA%\Composer\config.json被杀软锁定，或COMPOSER_HOME环境变量未生效，导致composer config -g实际没改对文件
验证当前到底走哪个镜像源
别猜，直接看 Composer 自己认的源：
- 运行
composer config -g repo.packagist.url，应输出类似https://mirrors.aliyun.com/composer/（注意末尾必须有/） - 运行
composer diagnose，检查 “Repo:” 行是否匹配你的镜像地址 - 进项目目录，执行
composer update -vvv --dry-run，第一行日志会显示实际请求的 URL，比如GET https://mirrors.aliyun.com/composer/p2/laravel/framework.json - 如果输出是
https://packagist.org或报No repositories configured，说明镜像没生效
临时绕过所有配置，强制走指定镜像安装 laravel-admin
当你不确定哪层配置出了问题，或者只是想快速验证能否装通，就跳过所有缓存和配置：
- 删掉项目下的
vendor和composer.lock - 执行：
composer create-project laravel/laravel myapp --repository-url=https://mirrors.cloud.tencent.com/composer/（用腾讯云，同步快） - 进项目后，再执行：
composer require encore/laravel-admin --repository-url=https://mirrors.cloud.tencent.com/composer/ - 最后跑：
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"和php artisan admin:install - 这个方式完全不依赖
config.json或composer.json里的 repositories，命令级最高优先级
换源后仍报 SQLSTATE[42000]: Syntax error... key was too long
这跟镜像源无关，是 Laravel 5.4+ 默认字符串长度超过 MySQL 5.7 以下版本限制导致的，但容易误判为安装失败：
- 错误发生在
php artisan admin:install执行迁移时，不是 Composer 阶段 - 解决方法固定：在
app/Providers/AppServiceProvider.php的boot()方法里加一行：Schema::defaultStringLength(191); - 别漏掉
use Illuminate\Support\Facades\Schema; - 加完立刻重跑
php artisan admin:install，不用重新 composer install
最常被忽略的一点：换源命令末尾的 / 不是可选项，少了它 Composer 会拼出错误路径（比如 https://mirrors.aliyun.com/composerpackages.json），直接 404；还有就是 composer clear-cache 这一步，很多人改完配置就去 install，结果本地缓存的旧元数据还在作祟。
