laravel 迁移中添加 mysql 8.0+ 虚拟列必须用 db::statement() 手动执行 alter table，因原生 schema 构建器不支持 virtualas；stored 列需显式指定类型与长度、处理 null、建索引，并在回滚时手动删除。
MySQL 8.0+ 虚拟列在 Laravel 迁移中怎么加
必须用 DB::statement() 手动执行 ALTER TABLE ... ADD COLUMN ... AS (...) STORED/VIRTUAL，Laravel 原生迁移不支持虚拟列语法。Eloquent 无法直接映射虚拟列到模型属性，它只是 MySQL 层的计算字段，不是真实存储的列。
常见错误是试图用 $table->string('full_name')->virtualAs("CONCAT(first_name, ' ', last_name)") —— 这会报错，因为 Blueprint 没有 virtualAs 方法。
- 只适用于 MySQL 8.0+（5.7 支持但语法略有差异，且不推荐用于生产）
- 迁移里不能用
change()修改虚拟列定义，必须dropColumn()再重新DB::statement()添加 - 如果列要被索引（比如
VIRTUAL列加普通索引，或STORED列加主键/外键），必须显式声明STORED
Laravel 迁移中添加 STORED 虚拟列的实操写法
STORED 列物理写入磁盘，可建索引、可用于外键，适合需要查询性能或约束的场景（如按年份归档、状态组合判断）。写法必须绕过 Schema 构建器：
public function up(MigrationBuilder $migration)
{
DB::statement("ALTER TABLE users ADD COLUMN full_name VARCHAR(255) AS (CONCAT(first_name, ' ', last_name)) STORED");
DB::statement("CREATE INDEX idx_users_full_name ON users(full_name)");
}
注意：VARCHAR(255) 的长度必须显式指定，且要足够容纳计算结果，否则插入时会截断或报错；CONCAT() 中字段若可能为 NULL，需用 COALESCE(first_name, '') 避免整个结果变 NULL。
- 迁移回滚时，必须手动
DB::statement('ALTER TABLE users DROP COLUMN full_name') - 不要在
fillable或casts中包含该列，Eloquent 不会写入也不读取它（除非用selectRaw显式查） - 测试环境若用 SQLite，此迁移会直接失败——得用
DB::getDriverName() === 'mysql'做运行时判断
什么时候该用虚拟列，而不是 Accessor 或数据库视图
虚拟列是表结构的一部分，对应用层透明，ORM 查询无需改写；Accessor 是 PHP 层计算，每次获取都执行逻辑，无法用于 where() 或排序；视图则跨表复杂、权限管理麻烦。
- 需要
WHERE full_name LIKE '%john%'→ 必须用STORED虚拟列 + 索引 - 只是展示用，且计算简单（如
status_label对应枚举值）→ 用 Accessor 更灵活可维护 - 涉及多表 JOIN 或聚合 → 视图或查询构造器更合适，虚拟列不支持跨表表达式
- 表达式含子查询、函数如
NOW()、用户变量 → MySQL 禁止，虚拟列只接受确定性函数
虚拟列在 Eloquent 查询中怎么安全使用
不能当普通字段用 ->where('full_name', '...')，除非确认该列是 STORED 且已建索引；否则 MySQL 会全表扫描。正确姿势是显式声明：
User::select('id', 'first_name', 'last_name')
->selectRaw("CONCAT(first_name, ' ', last_name) as full_name")
->whereRaw("CONCAT(first_name, ' ', last_name) LIKE ?", ["%john%"])
->get();
但如果已建好 STORED 列和索引，就可直接 where('full_name', 'John Doe')，前提是确保迁移执行成功且表结构同步。
- 部署时容易漏掉虚拟列迁移，导致线上查询报
Unknown column 'full_name' - 数据库备份还原后，虚拟列定义不会丢失，但依赖的源字段若被删，查询会直接报错
- 使用
DB::listen()监控慢查询时，要注意虚拟列参与的条件是否真走索引（用EXPLAIN验证）
GENERATED ALWAYS AS），而 Laravel 迁移本身并不抽象这一层。
