Laravel 默认只扫描 database/migrations 根目录下的迁移文件，若将迁移置于子文件夹中（如 database/migrations/2023_custom/），php artisan migrate 不会自动识别——需通过服务提供者显式注册额外路径。
laravel 默认只扫描 `database/migrations` 根目录下的迁移文件，若将迁移置于子文件夹中（如 `database/migrations/2023_custom/`），`php artisan migrate` 不会自动识别——需通过服务提供者显式注册额外路径。
在 Laravel 中，php artisan migrate 命令默认仅加载 database/migrations/ 目录下的所有 .php 文件，不递归扫描子目录。因此，即使你使用 --path 参数成功创建了位于子文件夹（如 database/migrations/v2/）中的迁移文件，它也不会被自动发现和执行，导致 Nothing to migrate. 提示，且该迁移不会出现在 migrations 数据表中。
✅ 正确解决方案：在服务提供者中注册自定义迁移路径
推荐在 AppServiceProvider 的 boot() 方法中调用 loadMigrationsFrom()，它专为此场景设计，支持传入一个路径数组，且具备延迟加载优势（避免提前解析 migrator 实例）：
// app/Providers/AppServiceProvider.php
use Illuminate\Support\Facades\Schema;
public function boot()
{
// ✅ 推荐方式：支持多个路径，语义清晰，延迟加载
$this->loadMigrationsFrom([
database_path('migrations'),
database_path('migrations/v2'),
database_path('migrations/tenant'),
// 可按需添加更多路径
]);
}
⚠️ 注意事项：
- 路径必须是绝对路径，务必使用
database_path()辅助函数生成； - 所有注册路径中的迁移文件将统一参与版本排序与执行（依据文件名前缀
Y_m_d_His_），Laravel 不区分来源目录； - 若多个路径中存在同名迁移（如重复时间戳），将触发冲突错误，需确保命名唯一；
- 修改服务提供者后，无需清理缓存即可立即生效（但建议运行
php artisan config:clear确保配置无残留）； -
loadMigrationsFrom()仅影响migrate、migrate:status、migrate:rollback等命令，不影响make:migration的默认行为。
? 小技巧：为提升可维护性，可将路径配置化
// config/database.php 中追加
'migration_paths' => [
database_path('migrations'),
database_path('migrations/features'),
database_path('migrations/legacy'),
],
然后在 AppServiceProvider@boot() 中动态读取：
$this->loadMigrationsFrom(config('database.migration_paths'));
总结：Laravel 迁移系统本身不支持“自动递归扫描子目录”，但通过 loadMigrationsFrom() 显式声明路径，即可安全、灵活地组织多层级迁移结构，兼顾团队协作规范与项目演进需求。
