laravel 8 中需显式设置模型的 $primarykey、$incrementing 和 $keytype 属性以支持非 id 主键，关联时还需在 belongsto 中指定外键与主键字段或依赖关联模型的 $primarykey。
当数据库表主键不是默认的 id 字段（例如用 des_id、user_code 或 uuid），而你又需要在关联关系中正确匹配外键与主键时，Laravel 8 默认会按 id 去查、去 join、去约束——这会导致 SQL 报错或数据查不到，哪怕表里明明有对应记录。
声明自定义主键字段名
在模型类中显式设置 $primaryKey 属性，值必须与数据库中真实主键列名完全一致（包括大小写、下划线）。
打开 app/Models/Destination.php，添加这一行：
protected $primaryKey = 'des_id';
这一步不加，所有基于主键的操作（find()、findOrFail()、delete()、关联加载）都会默认尝试查 id 字段，而表里根本没有该列，直接触发 SQLSTATE[42S22]: Column not found: 1054 Unknown column 'tbl_destinations.id' 错误。
处理非自增主键
若主键不是数据库 auto_increment 整数（如 UUID、字符串订单号、手动维护的 bigInteger），必须关闭自增标识。
在同一个模型中补充：
public $incrementing = false;
【不设此属性会导致 save() 插入时忽略你传入的主键值，反而尝试生成新 ID，最终写入 NULL 或 0】。比如你传 ['uuid' => 'abc-123'] 给 create()，Laravel 仍会跳过 uuid 字段，导致插入失败或主键冲突。
指定主键数据类型
如果主键是字符串（UUID、编码串等），必须声明类型，否则 Laravel 会把 find('abc') 强转成整型 0，查不到也不报错。
继续追加：
protected $keyType = 'string';
这个属性不是可选项——它直接影响 Eloquent 内部的类型绑定和 WHERE 条件构造。没设时，whereKey('a1b2c3') 实际执行的是 WHERE `des_id` = 0。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
关联关系中同步指定主键与外键
主键改了，关联逻辑也得对齐。Eloquent 默认按 id 匹配外键，现在要告诉它：“别找 id，找 des_id”。
方法一：在 belongsTo 关系中显式传参
比如 Destination 属于 Region，且 regions 表主键也是 reg_id：
return $this->belongsTo(Region::class, 'region_id', 'reg_id');
第二个参数是本模型的外键字段名（destination.region_id），第三个参数是关联模型的主键字段名（regions.reg_id）。
方法二：在关联模型中统一声明主键，再用约定调用
只要 Region 模型已设 protected $primaryKey = 'reg_id'，那么在 Destination 中就可以简写为：
return $this->belongsTo(Region::class, 'region_id');
此时 Eloquent 会自动读取 Region::$primaryKey 作为匹配依据，无需重复写第三参数。
第一步：打开 app/Models/Region.php
第二步：确认已设置 protected $primaryKey = 'reg_id';
第三步：回到 Destination.php，把 belongsTo 调用简化为两参数形式。
