Laravel迁移异常：SQLSTATE[42000] 1091错误及username字段未创建

1. 核对迁移文件代码 #

先确认你的迁移文件逻辑是否正确：

• up方法：确保添加字段的代码无误，示例：

  public function up()
  {
      Schema::table('users', function (Blueprint $table) {
          $table->string('username')->nullable(); // 根据需求调整字段属性
      });
  }
  

• down方法：如果up未生效，down方法执行dropColumn就会触发报错，示例：

  public function down()
  {
      Schema::table('users', function (Blueprint $table) {
          $table->dropColumn('username');
      });
  }
  

2. 修正migrations表记录 #

数据库migrations表显示迁移已执行，但实际字段未生成，说明迁移执行过程中出现了静默失败。直接删除该迁移的记录：

• 登录MySQL执行SQL：

  DELETE FROM migrations WHERE migration = '你的迁移文件名';
  

  比如迁移文件名为2024_05_20_123456_add_username_to_users_table.php，就填入对应的字符串。

3. 重新执行迁移 #

• 直接执行php artisan migrate，观察是否能正常生成username字段。
• 若之前执行migrate:rollback报错，删除migrations记录后无需先rollback，直接执行migrate即可。

4. 排查隐藏问题 #

• 数据库连接校验：检查.env文件中的DB_DATABASE、DB_HOST是否正确，避免连接到错误的数据库实例。
• 查看Laravel日志：打开storage/logs/laravel.log，搜索迁移相关的错误信息，可能migrate命令返回"成功"但实际存在未显示的异常。
• 事务问题：如果迁移文件中使用了DB::transaction，可能因内部错误导致事务回滚，却未在控制台输出错误。

5. 极端情况处理（仅适用于开发环境） #

如果以上方法都无效，且开发环境数据可丢弃：

1. 清空users表数据：TRUNCATE TABLE users;
2. 删除migrations表中所有记录：TRUNCATE TABLE migrations;
3. 重新执行所有迁移：php artisan migrate

内容的提问来源于stack exchange，提问作者Gabriel Rogath