根本原因是误对text()字段添加unique()或index()索引；应改用fullText()、去掉索引，或换为带长度的string(191)->index()。
text() 字段在迁移中报错 Specified key was too long 怎么办
根本原因不是 text() 本身出问题，而是你误给它加了索引约束（比如 ->unique() 或 ->index()）。MySQL 不允许对 TEXT 类型字段直接建全文索引以外的普通索引——尤其当表字符集是 utf8mb4 时，text() 默认无长度限制，引擎无法计算索引前缀长度，直接抛 Specified key was too long。
常见错误写法：
$table->text('content')->unique(); // ❌ 报错
$table->text('description')->index(); // ❌ 同样报错
- ✅ 正确做法：去掉索引，或改用带长度限制的
string()（如需索引） - ✅ 若真要索引长文本内容，用
->fullText()（MySQL 5.6+ 支持）：$table->text('content')->fullText(); - ✅ 或手动指定前缀长度（仅限
string()）：$table->string('summary', 191)->index();
longText() / mediumText() 迁移失败提示 SQLSTATE[42000] 怎么排查
这类错误多出现在 MySQL 5.7 以下版本或严格模式开启时：longText() 和 mediumText() 是 Laravel 封装方法，底层映射为 LONGTEXT / MEDIUMTEXT，但某些旧版 MySQL 驱动或 PDO 配置会拒绝识别这些类型名，转而报语法错误。
- 检查 MySQL 版本：
SELECT VERSION();—— 若低于 5.7，建议升级或改用text() - 确认
config/database.php中 MySQL 连接配置未强制覆盖strict模式：'strict' => true在低版本下可能拒绝非标准类型 - 绕过构建器，用原生语句定义（兼容性更强）：
$table->addColumn('longtext', 'payload'); - 注意：Laravel 10+ 已明确支持
longText()，但若项目混用了自定义 Doctrine DBAL 补丁，需验证其 type mapping 是否注册了longtext
text() 字段加 comment() 含单引号或换行就崩
comment() 方法不自动转义，MySQL 解析到 ' 或
会直接触发 SQLSTATE[42000]: Syntax error or access violation。哪怕只是注释里写了 "用户's 备注" 或从配置读来的多行字符串，都会失败。
- ✅ 必须清洗后再传入：
$table->text('notes')->comment(str_replace([" ", " "], " ", addslashes($desc))); - ✅ 更稳妥的做法是封装一个辅助函数：
clean_comment($text)，统一处理单引号、双引号、换行、长度截断（MySQL 注释上限 1024 字节） - ⚠️ 注意：
addcslashes($str, "'"\")比addslashes()更精准，避免误转其他斜杠 - 别依赖 IDE 自动换行或复制粘贴的文档——所有注释内容必须经清洗函数过滤，不能直传原始变量
修改 text() 字段类型或长度时报错 Unsupported alter operation
这是典型缺少 doctrine/dbal 导致的静默失败。Laravel 默认不内置表结构差异检测能力，change() 对 text() 类型变更（如改 text() 为 longText()，或加 collation()）必须靠 DBAL 解析当前列定义，否则直接跳过或报错。
- ✅ 第一步：安装依赖：
composer require doctrine/dbal - ✅ 第二步：确保迁移中显式调用
->change()：$table->longText('body')->change(); - ⚠️ 关键点：DBAL 只能处理已存在字段的变更，不能用于新建字段；且
text()类型不支持collation()链式调用（会静默忽略），需用addColumn()+ raw 参数 - 生产环境执行前务必在本地用
php artisan migrate --pretend预览生成的 SQL，确认是否含预期的MODIFY COLUMN
SHOW CREATE TABLE 或 information_schema.COLUMNS 确认最终结构。 
