使用Xethron/migrations-generator后Laravel 5.6迁移报错问题

嘿，我太懂你这种用Xethron/migrations-generator生成迁移后，手动改文件执行却报错的糟心感了——之前帮朋友排查过好几个类似的情况，咱们先从最常见的几个问题入手排查：

1. 迁移文件语法写错了 #

这是最容易踩的坑！手动加列时很容易犯小错误：比如漏写括号、字段类型拼写错、参数格式不对。举个例子：

// 正确的字符串列写法
$table->string('new_column', 255);
// 错误写法（少了括号、引号位置错）
$table->string'new_column';

仔细检查你添加的列定义：有没有用数据库不支持的类型（比如MySQL不支持jsonb，PostgreSQL才支持），有没有遗漏必填参数，符号是不是都配对了。

2. 改了已经执行过的迁移文件 #

Laravel会把已执行的迁移记录在migrations表里，如果你修改的是已经跑过的迁移文件，再执行php artisan migrate时，Laravel会直接跳过它，甚至可能因为表结构和迁移记录不匹配而报错。

解决办法分两种情况：

• 还在本地开发环境：先回滚最近一次迁移，再重新执行

  php artisan migrate:rollback
  php artisan migrate
  

• 已经部署到生产环境：绝对不能修改已执行的迁移！应该新建一个专门的迁移文件来加列：

  php artisan make:migration add_new_column_to_[your_table]_table --table=[your_table]
  

  然后在这个新迁移的up()方法里写添加列的代码：

  public function up()
  {
      Schema::table('[your_table]', function (Blueprint $table) {
          $table->string('new_column')->nullable();
      });
  }
  

3. 数据库字段冲突或数据不兼容 #

比如你要加的列名已经存在，或者要加非空字段但表中已有数据（数据库不知道该给现有行填什么值）。

• 先去数据库里查一下目标表，确认要加的列名没被占用
• 如果是非空字段，要么给个默认值，要么先设为允许为空：

  // 允许为空
  $table->string('new_column')->nullable();
  // 设置默认值
  $table->integer('status')->default(1);
  

4. Xethron生成的迁移和Laravel原生语法的兼容性 #

Xethron生成的迁移有时候会带一些特定的写法，比如自定义的索引、字段注释之类的，手动修改时要保持和原有代码风格一致，不要破坏原有结构。比如如果原有迁移用了$table->engine = 'InnoDB';，修改时别删掉这条。

5. 数据库权限或连接问题 #

少见但也可能发生：比如Laravel配置的数据库用户没有ALTER TABLE的权限，导致无法修改表结构。你可以先手动在数据库客户端执行ALTER TABLE [your_table] ADD COLUMN new_column VARCHAR(255);试试，如果也报错，那就是权限问题，找数据库管理员开权限就行。

如果这些方法都没解决，把具体的错误提示（比如SQL语句报错、Laravel的栈信息）贴出来，我能帮你更精准定位问题～

内容的提问来源于stack exchange，提问作者Alain Agnero