Laravel迁移重命名含连字符列时出现SQL语法错误求助

这个问题的根源很明确：你的原列名content-description包含连字符，在MariaDB/MySQL中，这类包含特殊字符的标识符必须用**反引号（）**包裹，否则SQL解析器会把连字符误认为是减号，从而抛出语法错误。而Laravel默认的renameColumn`方法并没有自动为带特殊字符的列名添加反引号，导致执行的SQL语句不符合语法规范。

下面给你两种可行的解决方案：

方案一：手动编写SQL语句（推荐，不会丢失数据） #

直接使用DB::statement执行带反引号的SQL语句，明确包裹特殊列名：

class ModifyColumnName extends Migration {
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up() {
        // 注意替换数据类型为你原列的实际类型（比如TEXT、MEDIUMTEXT等）
        DB::statement('ALTER TABLE posts CHANGE `content-description` `content_description` VARCHAR(255) DEFAULT NULL');
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down() {
        // 回滚时也要用同样的方式改回去
        DB::statement('ALTER TABLE posts CHANGE `content_description` `content-description` VARCHAR(255) DEFAULT NULL');
    }
}

⚠️ 注意：要确保SQL中的数据类型（VARCHAR(255)）和原列的实际类型一致，如果原列是TEXT或者其他类型，记得对应修改，避免数据异常。

方案二：先删除原列再新增列（不推荐，会丢失数据） #

如果你的数据已经备份或者可以重新生成，可以先删除原列，再添加新列，但这种方式会丢失原列的所有数据，只适合测试环境或者无重要数据的场景：

public function up() {
    Schema::table('posts', function (Blueprint $table) {
        $table->dropColumn('content-description');
        $table->string('content_description')->nullable();
    });
}

public function down() {
    Schema::table('posts', function (Blueprint $table) {
        $table->dropColumn('content_description');
        $table->string('content-description')->nullable();
    });
}

额外建议 #

以后设计数据库列名时，尽量避免使用连字符、空格这类特殊字符，优先使用下划线（_）或者驼峰命名法，这样不仅能避免这类语法错误，也更符合数据库的命名规范，减少后续维护的麻烦。

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