当Laravel模型定义了自定义主键（protected $primaryKey），但在数据更新操作中遇到“Unknown column ‘id’ in ‘where clause’”错误时，通常是由于数据库表中实际缺少该自定义主键列所致。本文将深入分析此问题，并提供确保模型与数据库表结构一致性的解决方案，以确保自定义主键在CRUD操作中正常工作。
理解Laravel中的主键与自定义需求
在laravel的eloquent orm中，每个模型默认都假定其对应的数据库表拥有一个名为 id 的自增主键。然而，在实际开发中，我们可能需要使用不同的列作为主键，例如 uuid、业务相关的编码（如 product_code）或者像示例中那样使用 pages_id。laravel提供了 protected $primarykey 属性来声明自定义主键。
class Page extends Model{ use HasFactory; // 声明自定义主键 protected $primaryKey = 'pages_id'; protected $fillable = [ 'is_default_home', 'is_default_not_found', 'title', 'slug', 'content', ];}
当模型中设置了 protected $primaryKey = ‘pages_id’; 后，Laravel在执行 find()、update()、delete() 等操作时，会尝试使用 pages_id 作为查询条件。
问题现象：’id’ 列不存在错误分析
尽管模型中明确指定了 pages_id 为主键，但在进行数据更新时，却可能遇到如下错误：
SQLSTATE[42S22]: Column not found: 1054 Unknown column 'id' in 'where clause' (SQL: select count(*) as aggregate from `pages` where `slug` = about and `id` 3)
这个错误消息表明，在某个查询（在此例中是一个验证查询，用于检查 slug 字段的唯一性，同时排除当前记录）中，Laravel仍然尝试查找名为 id 的列，而不是我们自定义的 pages_id。
根本原因分析：出现此错误最常见且直接的原因是：尽管您在模型中声明了 protected $primaryKey = ‘pages_id’;，但对应的数据库表 pages 中，实际上并不存在名为 pages_id 的列。
当Laravel无法找到模型声明的自定义主键列时，它在某些内部操作（尤其是涉及到通过主键排除当前记录的唯一性验证等场景）中，可能会回退到默认的 id 列。如果 id 列也不存在，或者不符合预期的主键行为，就会导致上述“Unknown column ‘id’”错误。
解决方案：确保数据库表结构与模型定义一致
解决此问题的核心在于确保数据库表 pages 中确实存在名为 pages_id 的列，并且该列能够作为主键使用。
步骤一：检查数据库表结构
使用数据库管理工具（如phpMyAdmin、DataGrip、Navicat等）直接检查 pages 表的结构。确认是否存在一个名为 pages_id 的列。
步骤二：创建或修改数据库列
如果 pages_id 列不存在，您需要将其添加到 pages 表中。在Laravel中，推荐使用迁移（Migrations）来管理数据库结构。
示例：创建带有自定义主键的迁移
如果您尚未创建 pages 表，可以在新的迁移中定义 pages_id 作为主键：
// php artisan make:migration create_pages_table --create=pagesuse IlluminateDatabaseMigrationsMigration;use IlluminateDatabaseSchemaBlueprint;use IlluminateSupportFacadesSchema;class CreatePagesTable extends Migration{ public function up() { Schema::create('pages', function (Blueprint $table) { // 定义自定义主键 $table->id('pages_id'); // Laravel 8+ 语法，自动创建 bigIncrements // 或者使用更明确的定义： // $table->bigIncrements('pages_id'); // 如果需要自增 // $table->uuid('pages_id')->primary(); // 如果使用 UUID 作为主键 // $table->string('pages_id')->primary(); // 如果是字符串主键 $table->boolean('is_default_home')->default(false); $table->boolean('is_default_not_found')->default(false); $table->string('title'); $table->string('slug')->unique(); // 确保 slug 唯一 $table->longText('content'); $table->timestamps(); }); } public function down() { Schema::dropIfExists('pages'); }}
如果 pages 表已经存在，但没有 pages_id 列，您可以创建一个新的迁移来添加该列：
// php artisan make:migration add_pages_id_to_pages_table --table=pagesuse IlluminateDatabaseMigrationsMigration;use IlluminateDatabaseSchemaBlueprint;use IlluminateSupportFacadesSchema;class AddPagesIdToPagesTable extends Migration{ public function up() { Schema::table('pages', function (Blueprint $table) { // 添加 pages_id 列，并设置为自增主键 // 注意：如果表中已有数据，添加主键需要额外处理，如先添加列，再填充数据，最后设置为 primary key // 简单示例，假设表为空或可接受数据丢失： $table->dropColumn('id'); // 如果原先有默认的 'id' 列，且您不希望保留 $table->bigIncrements('pages_id')->first(); // 添加为第一个列，并设置为自增主键 }); } public function down() { Schema::table('pages', function (Blueprint $table) { $table->dropPrimary('pages_id'); // 移除主键约束 $table->dropColumn('pages_id'); // 删除列 $table->id(); // 重新添加默认的 'id' 列（如果需要） }); }}
在运行迁移之前，请务必备份您的数据库。运行迁移命令：
php artisan migrate
步骤三：验证控制器中的更新逻辑
确保控制器中的更新逻辑正确地传递了自定义主键的值。
public function update(){ // 执行验证，确保 slug 唯一性检查时能够正确排除当前记录 // 这里的 validate() 方法内部会使用模型的主键来构建排除当前记录的查询 $this->validate([ 'slug' => 'required|unique:pages,slug,' . $this->modelId . ',pages_id', // 明确指定排除的列是 pages_id // 其他验证规则... ]); $this->unassignedDefaultHomePage(); $this->unassignedDefaultNotFoundPage(); // 使用 Page::find() 方法，它会根据模型定义的 $primaryKey 来查找记录 Page::find($this->modelId)->update($this->modelData()); $this->modalFormVisible = false; $this->reset();}public function modelData(){ return [ 'title' => $this->title, 'slug' => $this->slug, 'content' => $this->content, 'is_default_home' => $this->isSetToDefaultHomePage, 'is_default_not_found' => $this->isSetToDefaultNotFoundPage, ];}
在 validate() 方法中，如果使用了 unique 规则，并且需要排除当前正在更新的记录，务必在规则中明确指出用于排除的键名。例如：’unique:table,column,except,idColumn’。在示例中，’unique:pages,slug,’ . $this->modelId . ‘,pages_id’ 明确告诉Laravel，在检查 slug 唯一性时，排除 pages_id 为 $this->modelId 的记录。
注意事项与最佳实践
一致性是关键： 模型中的 protected $primaryKey 属性值必须与数据库表中实际的主键列名完全一致。任何拼写错误或不匹配都会导致问题。使用迁移： 始终通过Laravel迁移来管理数据库模式。这确保了开发环境的一致性，并使得数据库结构变更可追踪。主键类型： 根据您的需求选择合适的主键类型（自增整数、UUID、字符串等）。如果是非自增主键，您可能还需要在模型中设置 public $incrementing = false;。缓存清除： 在修改模型或数据库结构后，有时可能需要清除Laravel的配置缓存和路由缓存，以确保所有更改生效：
php artisan config:clearphp artisan route:clearphp artisan cache:clear
调试： 如果问题依然存在，可以使用 dd() 或 Laravel Debugbar 来检查 $this->modelId 的值是否正确，以及 Page::find() 之前和之后生成的SQL查询语句，以进一步定位问题。
总结
当Laravel模型定义了自定义主键但在更新时遇到“Unknown column ‘id’”错误时，最根本的原因是数据库中缺少模型声明的自定义主键列。通过检查并确保数据库表结构与模型定义完全一致，特别是自定义主键列的名称和存在性，可以有效地解决此类问题。遵循Laravel的迁移机制，并注意验证规则中主键的正确引用，将有助于构建健壮且易于维护的应用程序。
以上就是Laravel自定义主键更新失败：’id’ 列不存在错误解析与解决方案的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1267270.html
微信扫一扫 
支付宝扫一扫 
