Composer自动发现机制通过扫描vendor/composer/installed.php中各包extra.laravel.providers字段，将服务提供者类名动态注入config/app.php的providers数组，仅在Laravel启动时生效，需配合php artisan config:clear刷新缓存。
Composer 自动发现机制是怎么工作的
Composer 的自动发现（Package Discovery）不是 Laravel 独有的功能，而是由 composer.json 中的 "extra": {"laravel": {"dont-discover": [...]}} 和包作者主动声明的 "extra": {"laravel": {"providers": [...]}} 共同驱动的。它只在 Laravel 应用执行 composer install 或 composer update 时触发，且仅对已安装、且满足 Laravel 版本约束的包生效。
关键点：自动发现 ≠ 自动注册服务提供者。它只是 Laravel 在启动时读取 vendor/composer/installed.php，再扫描每个包的 extra.laravel.providers 字段，把对应类名加入 config/app.php 的 providers 数组——这个过程发生在框架引导阶段，不依赖用户手动编辑配置文件。
Laravel 包作者必须写的 composer.json 配置
如果你是包开发者，想让自己的包支持自动发现，必须在包的 composer.json 里明确声明服务提供者：
{
"name": "acme/my-package",
"extra": {
"laravel": {
"providers": [
"Acme\MyPackage\MyPackageServiceProvider"
],
"aliases": {
"MyPackage": "Acme\MyPackage\Facades\MyPackage"
}
}
}
}
注意以下几点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
providers数组里的类必须真实存在，且继承自IlluminateSupportServiceProvider -
aliases是可选的，但一旦写了，Laravel 会尝试注册该门面（Facade），前提是该类有getFacadeAccessor()方法 - 不要写
"dont-discover": ["*"]到自己包里，这会禁用所有发现逻辑 - 如果包同时支持非 Laravel 环境，建议用条件判断隔离服务提供者逻辑，避免在非 Laravel 项目中报错
为什么 composer update 后没生效？常见卡点
自动发现不是“实时”的，也不是“永久缓存”的。最常被忽略的是以下三个环节：
- Laravel 的配置缓存未刷新：
php artisan config:clear必须执行，否则旧的config/app.php仍被使用 - 包本身未被正确 require 进项目：
composer show acme/my-package要能查到，且版本满足"require": {"laravel/framework": "^10.0"}这类约束 - 包的
extra.laravel字段在vendor/composer/installed.php中缺失：运行composer dump-autoload并检查该文件里对应包的extra键是否存在、结构是否完整 - 应用启用了
APP_DEBUG=false且未清缓存，会导致服务提供者加载失败但无提示
不想用自动发现？怎么手动关掉
有些场景你确实需要跳过自动发现，比如调试冲突、或临时禁用某个包的服务提供者：
- 全局禁用：
composer.json项目根目录下加"extra": {"laravel": {"dont-discover": ["*"]}}，然后composer update - 只禁一个包：
"extra": {"laravel": {"dont-discover": ["acme/my-package"]}} - 运行时绕过（仅限开发）：启动前设置环境变量
COMPOSER_DISCOVER=0，Laravel 会跳过整个发现流程
注意：dont-discover 只影响新安装/更新后的发现行为，已写死在 config/app.php 里的服务提供者不会被自动移除。
自动发现省的是手动编辑配置的步骤，不是省掉理解服务提供者生命周期的责任。最容易出问题的地方，其实是包内 register() 和 boot() 里依赖了尚未加载的其他服务——这种错误不会在 composer update 时报，而是在第一次 HTTP 请求时才暴露。
