Laravel Lumen无迁移文件时执行migrate报错问题排查

这个错误的核心原因是：你的Lumen数据库配置中缺少了迁移记录表的名称定义。

当你执行php artisan migrate时，即使没有任何迁移文件，Laravel/Lumen底层也会先尝试检查或创建用于记录迁移状态的表（默认叫migrations）。但你的database.php配置里没有指定这个表名，导致框架生成SQL时使用了空字符串作为表名，从而抛出Incorrect table name ''的错误。

解决步骤 #

你只需要在database.php的配置数组中添加migrations键，指定迁移记录表的名称即可（通常默认用migrations）：

修改后的database.php代码如下：

<?php
return [
    'default' => 'mysql',
    'migrations' => 'migrations', // 新增这一行，指定迁移记录表名
    'connections' => [
        'mysql' => [
            'driver' => 'mysql',
            'host' => env('DB_HOST'),
            'port' => env('DB_PORT'),
            'database' => env('DB_DATABASE'),
            'username' => env('DB_USERNAME'),
            'password' => env('DB_PASSWORD'),
            'charset' => 'utf8',
            'collation' => 'utf8_unicode_ci',
        ]
    ]
];

可选优化（更灵活的配置方式） #

如果你想通过环境变量来控制这个表名，可以在.env里添加：

DB_MIGRATIONS_TABLE=migrations

然后在database.php中引用这个变量：

'migrations' => env('DB_MIGRATIONS_TABLE', 'migrations'),

验证修改效果 #

修改完成后，再次执行php artisan migrate：

• 如果迁移记录表不存在，框架会自动创建它，然后因为没有待执行的迁移文件，会输出Nothing to migrate.
• 如果迁移记录表已经存在，框架会直接检查迁移文件列表，发现没有需要执行的内容后直接退出，不会再报错。

而php artisan migrate:status依然会输出No migrations found.，这是符合预期的，因为你确实还没有创建任何迁移文件。

内容的提问来源于stack exchange，提问作者Daniel Becker