MySQL 8+ 中修改表注释须用 DB::statement() 执行 ALTER TABLE ... COMMENT，因 Laravel 原生迁移不支持；需手动实现 down() 回滚，且注释超长（2048字符）会静默截断。
MySQL 8+ 中用 DB::statement() 直接执行 COMMENT 修改
Laravel 原生迁移不支持直接修改表注释（COMMENT），Schema::table() 也没有 comment() 方法。最稳妥的做法是绕过 Schema 构建器，用原生 SQL 执行 ALTER TABLE ... COMMENT。这要求你确认数据库是 MySQL 5.7+ 或 MariaDB 10.2+（低版本不支持表级 COMMENT）。
在迁移文件中写：
public function up(MigrationBuilder $migration)
{
DB::statement("ALTER TABLE users COMMENT = '用户主表，含登录凭证与基础资料'");
}
注意：DB::statement() 不受 Laravel 迁移回滚机制自动管理，所以 down() 必须手动补全，否则 php artisan migrate:rollback 会失败或留下脏数据：
public function down(MigrationBuilder $migration)
{
DB::statement("ALTER TABLE users COMMENT = ''");
}
使用 doctrine/dbal 扩展读取/修改表注释（兼容性更强）
如果你需要动态读取当前注释、做条件判断，或者希望代码更“Laravel 风格”，可以借助 doctrine/dbal —— Laravel 官方推荐的底层 Schema 工具。先安装：composer require doctrine/dbal。
然后在迁移中这样操作：
use Doctrine\DBAL\Schema\Schema;
use Illuminate\Support\Facades\DB;
public function up(MigrationBuilder $migration)
{
$schema = DB::connection()->getDoctrineSchemaManager();
$table = $schema->listTableDetails('users');
// 获取当前注释（可能为 null）
$currentComment = $table->getComment() ?: '';
// 仅当注释不同才更新，避免无意义变更
if ($currentComment !== '用户主表，含登录凭证与基础资料') {
DB::statement("ALTER TABLE users COMMENT = '用户主表，含登录凭证与基础资料'");
}
}
这个方式适合 CI/CD 环境中防止重复执行，也便于后续扩展逻辑（比如批量更新多个表注释）。但要注意：doctrine/dbal 在 SQLite 和 PostgreSQL 下行为不一致，MySQL 是最稳妥的选择。
字段注释也能改，但语法和表注释不同
如果目标其实是改某个字段的注释（比如 name 字段），不能复用表注释的写法。MySQL 中字段注释必须用 MODIFY COLUMN 或 CHANGE COLUMN，且需保留原有字段定义（类型、是否 null、默认值等），否则会丢失结构。
例如给 users.name 加注释，正确写法是：
DB::statement("ALTER TABLE users MODIFY COLUMN name VARCHAR(255) NOT NULL COMMENT '用户真实姓名，不可为空'");
常见错误包括：
- 漏写字段类型和约束（导致字段被重置为
VARCHAR(255)+NULL） - 用
ALTER TABLE ... CHANGE COLUMN name name ...却没写两次字段名（MySQL 要求显式重复） - 在 JSON 字段上加 COMMENT（MySQL 8.0.29+ 才支持，旧版会报错
SQLSTATE[HY000]: General error: 1064）
生产环境执行前务必验证 SQL 是否可逆
表注释本身不影响查询逻辑，但 ALTER TABLE ... COMMENT 在某些 MySQL 配置下会触发表重建（比如启用了 innodb_file_per_table=OFF 或使用 MyISAM 引擎），导致锁表时间变长。尤其在大表（千万级行）上，一次 COMMENT 修改可能阻塞写入数秒到分钟级。
建议做法：
- 在预发库用
EXPLAIN ALTER TABLE users COMMENT = 'xxx'（MySQL 8.0.23+ 支持）看是否涉及 copy - 避免在业务高峰执行；如必须，加上
ALGORITHM=INPLACE, LOCK=NONE（仅限支持的引擎和操作） - 注释内容不要含单引号、反斜杠等未转义字符，否则
DB::statement()会报语法错误
真正容易被忽略的是：很多团队把注释当成“文档”写得很长，但 MySQL 表注释最大只支持 2048 字符，超长会被截断且不报错 —— 最好提前 strlen() 校验。
