MySQL 5.7+ 要求 COMMENT 值必须是单行字符串，含 \n 或 \r\n 会触发语法错误；Laravel 迁移中需手动清洗换行符为空格，并注意 DDL 不支持事务回滚。
MySQL字段注释含换行符直接报错
MySQL 5.7+ 要求 COMMENT 值必须是单行字符串，遇到 \n 或 \r\n 会触发 SQLSTATE[42000]: Syntax error or access violation。Laravel 的 Schema::table() 或迁移文件里若用原生字符串写多行注释（比如从文档复制、IDE 自动换行），就会崩。
- 别在
comment()参数里直接拼接"第一行\n第二行"—— MySQL 不认 - 注释内容来自配置或数据库字段描述？先用
str_replace(["\n", "\r"], " ", $text)清洗 - Laravel 9+ 的
use Illuminate\Support\Facades\DB;执行原生ALTER TABLE时，也得自己处理换行，不能依赖框架过滤
用 DB::statement() 手动建表时注释要转义空格
想绕过 Schema 构建器直接发 SQL？注意 MySQL 对注释里不可见字符极其敏感。哪怕只是 COMMENT 'a\nb'，服务端解析就失败；但 COMMENT 'a b' 是安全的。
-
DB::statement("ALTER TABLE users COMMENT = '用户主表，用于登录和权限')—— 没问题 -
DB::statement("ALTER TABLE users COMMENT = '用户主表\n用于登录和权限')—— 必报错 - 如果非得保留语义换行，建议前端展示时再还原，数据库层统一存空格分隔
- 某些 MySQL 客户端（如 DBeaver）显示注释时会自动折行，不代表字段本身支持换行
php artisan migrate 失败后注释没回滚
迁移中注释出错，up() 中间断掉，但前面的字段新增/修改可能已生效，而注释没加上——这会导致结构和预期不一致，下次再跑又因重复操作报错。
- 不要把
comment()和字段变更写在同一Schema::table()调用里，拆成两步：先改结构，再单独设注释 - 在
down()方法里，用DB::statement("ALTER TABLE ... MODIFY COLUMN ... COMMENT ''")显式清空，别依赖dropColumn() - 本地开发可加
DB::transaction()包裹整段迁移逻辑，但注意：DDL 语句（如ALTER）在 MySQL 中会自动提交，事务无效
Laravel 10+ 的 comment() 方法默认不处理换行
新版 Laravel 并没有内置对注释内容的标准化清洗，comment() 就是原样塞进 SQL 字符串。它不帮你 trim，不帮你替换换行，也不校验长度（MySQL 注释上限 1024 字符）。
- 自定义一个辅助函数：
function clean_comment($text) { return mb_substr(str_replace(["\r\n", "\n", "\r"], " ", $text), 0, 1024); } - 所有迁移里调用
->comment(clean_comment($desc))，而不是直传原始变量 - 如果用到了 Doctrine DBAL（比如生成迁移骨架），它的
getComment()返回值也可能带换行，同样要清洗
换行符看着小，但在数据库 DDL 层就是语法硬伤；没人会特意查“为什么 comment 有 \n 就报错”，大多时候卡在报错信息不明确上。
