在 Laravel 中，Schema::getColumnListing() 默认返回按字母排序的列名，无法反映建表时的实际顺序；本文介绍通过模型实例的属性键来准确获取列的物理定义顺序，并提供安全可靠的实现方案。
在 laravel 中，`schema::getcolumnlisting()` 默认返回按字母排序的列名，无法反映建表时的实际顺序；本文介绍通过模型实例的属性键来准确获取列的物理定义顺序，并提供安全可靠的实现方案。
Laravel 的 Schema::getColumnListing($table) 方法底层调用数据库信息模式（如 MySQL 的 INFORMATION_SCHEMA.COLUMNS），但其结果不保证按 ordinal_position 排序——尤其在某些驱动或版本中，它可能被默认按 column_name 字母序返回，导致与迁移文件或实际建表顺序不一致。
要真正获得列在表结构中的物理定义顺序（即 CREATE TABLE 语句中声明的顺序，对应 INFORMATION_SCHEMA.COLUMNS.ORDINAL_POSITION），推荐使用以下更可靠、ORM 原生的方式：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
✅ 推荐方案：通过模型实例的原始属性键获取顺序
use Illuminate\Support\Facades\Schema;
use App\Models\User;
// 方式 1：使用已存在的记录（需确保有数据）
$user = User::first();
if ($user) {
$orderedColumns = array_keys($user->getOriginal());
dd($orderedColumns);
// 输出示例：["id", "name", "email", ..., "updated_at"]
}
// 方式 2：无依赖数据的健壮写法（推荐）
$dummyUser = new User();
// 强制初始化所有fillable属性为null，触发属性映射
$attributes = $dummyUser->getAttributes();
// 注意：getAttributes() 返回的是当前模型状态，可能含默认值或访问器影响
// 更稳妥的做法是结合 Schema 获取字段 + 显式排序⚠️ 重要说明：
- getOriginal() 返回的是从数据库读取的原始字段值（键名即列名），其键顺序由 Eloquent 模型在 hydrate 过程中依据查询结果集字段顺序决定 —— 而该顺序通常与 SELECT * 的列序一致，即匹配表定义顺序（前提是未手动指定 select() 字段）。
- 但若模型启用了 $casts、$appends 或自定义 getAttributes()，可能干扰结果。因此生产环境建议搭配数据库元数据验证：
? 补充验证：直接查询 INFORMATION_SCHEMA（跨数据库兼容性稍弱，但最权威）
use Illuminate\Support\Facades\DB;
$table = (new User())->getTable();
$connection = DB::connection()->getPdo();
if ($connection instanceof \PDO) {
$columns = DB::select("
SELECT column_name
FROM information_schema.columns
WHERE table_schema = ?
AND table_name = ?
ORDER BY ordinal_position
", [
DB::connection()->getDatabaseName(),
$table
]);
$orderedColumns = array_column($columns, 'column_name');
dd($orderedColumns);
}✅ 总结建议：
- 优先使用 array_keys((new Model)->getOriginal()) —— 简洁、高效、无需额外查询，适用于绝大多数标准 Eloquent 场景；
- 若需 100% 确保与数据库物理顺序一致（如生成文档、比对迁移），应直接查询 INFORMATION_SCHEMA.COLUMNS 并按 ORDINAL_POSITION 排序；
- 避免依赖 Schema::getColumnListing() 的返回顺序，因其行为未在 Laravel 文档中承诺稳定性，且受底层驱动实现影响。
