怎样在 Slim 框架中正确使用 Laravel Eloquent 插入数据

本文详解在 slim（非 laravel）环境中集成 illuminate/database + eloquent 时，插入数据失败的常见原因及完整解决方案，涵盖模型配置、时间戳字段缺失修复、数据库连接初始化和错误调试方法。

本文详解在 slim（非 laravel）环境中集成 illuminate/database + eloquent 时，插入数据失败的常见原因及完整解决方案，涵盖模型配置、时间戳字段缺失修复、数据库连接初始化和错误调试方法。

在 Slim 框架中独立使用 Laravel Eloquent（即“Slim + Illuminate Eloquent”组合）是一种轻量级但易出错的实践。你遇到的 500 Internal Error 并非 Eloquent 本身问题，而是底层 SQL 执行失败导致的——核心原因在于：你的 users 表缺少 Eloquent 默认要求的时间戳字段 created_at 和 updated_at。

Eloquent 的 Model::create() 方法默认会尝试自动写入 created_at 和 updated_at 字段（除非显式禁用）。而你的表结构中仅有 created_on 和缺失 updated_at，且未关闭时间戳功能，导致 INSERT 语句因字段不存在而报错（如 SQLSTATE[42S22]: Column not found），最终被封装为 500 错误。

✅ 正确做法分三步：

1. 补全或适配时间戳字段（推荐方案）

修改数据库表，添加 Eloquent 标准时间戳字段（最兼容）：

ALTER TABLE `users`  ADD COLUMN `created_at` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,  ADD COLUMN `updated_at` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

同时，在模型中明确指定时间戳字段名（若坚持用 created_on/updated_on）：

// App/Models/User.phpnamespace AppModels;use IlluminateDatabaseEloquentModel;class User extends Model{    protected $table = 'users';    protected $fillable = ['first_name', 'last_name'];    // ✅ 关键：覆盖默认时间戳字段名    const CREATED_AT = 'created_on';    const UPDATED_AT = 'updated_on'; // 注意：原表无此字段，需先添加}

⚠️ 若选择自定义字段名，请务必同步执行 ALTER TABLE users ADD COLUMN updated_on TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

2. 禁用时间戳（快速验证方案，不推荐生产使用）

若暂时无法修改表结构，可在模型中彻底关闭时间戳：

class User extends Model{    protected $table = 'users';    protected $fillable = ['first_name', 'last_name'];    public $timestamps = false; // ? 关键：禁用自动时间戳}

此时 create() 不再尝试写入 created_at/updated_at，可立即生效。

3. 确保 Eloquent 数据库连接已正确初始化

Slim 中需手动启动 Eloquent（常在 bootstrap/app.php 或 config/database.php 中）：

use IlluminateDatabaseCapsuleManager as Capsule;$capsule = new Capsule;$capsule->addConnection([    'driver'    => 'mysql',    'host'      => 'localhost',    'database'  => 'your_db',    'username'  => 'root',    'password'  => '',    'charset'   => 'utf8mb4',    'collation' => 'utf8mb4_unicode_ci',    'prefix'    => '',]);$capsule->setAsGlobal();$capsule->bootEloquent(); // ? 必须调用！否则模型无法连接数据库

4. Controller 中安全插入数据（含错误处理）

use AppModelsUser;use PsrHttpMessageResponseInterface as Response;use PsrHttpMessageServerRequestInterface as Request;public function index(Request $request, Response $response){    try {        // ✅ 使用 fill() + save() 替代 create() 可更好控制流程        $user = new User();        $user->fill([            'first_name' => $request->getParam('email'), // ⚠️ 注意：此处逻辑疑似有误，email 应存入 email 字段而非 first_name            'last_name'  => 'team',        ]);        $user->save();        return $response->withJson([            'success' => true,            'data'    => $user->toArray()        ], 201);    } catch (IlluminateDatabaseQueryException $e) {        error_log('DB Insert Error: ' . $e->getMessage());        return $response->withStatus(500)->withJson([            'success' => false,            'error'   => 'DATABASE_ERROR',            'message' => 'Failed to insert user'        ]);    }}

? 调试提示：

• 开启 Eloquent 查询日志定位具体 SQL 错误：DB::enableQueryLog(); dd(DB::getQueryLog());
• 检查 id 字段是否设为 AUTO_INCREMENT（当前 BIGINT NOT NULL 会导致主键冲突）：

  ALTER TABLE `users` MODIFY `id` BIGINT(20) NOT NULL AUTO_INCREMENT;

? 总结：Slim 中使用 Eloquent 插入失败，90% 源于时间戳字段缺失/不匹配或数据库连接未 bootEloquent()。补全 created_at/updated_at 字段并确保 $capsule->bootEloquent() 已执行，即可稳定使用 Model::create()。