怎样在 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()。
