ThinkPHP 6中需在模型类中显式声明protected $pk = '主键名'（如user_id）以支持非id主键，同时自增主键须配合protected $auto = true，时间戳功能需手动关闭或单独指定字段名。
如果您在ThinkPHP中使用数据库表的主键字段不是默认的id，例如为user_id、order_no或log_id，则模型将无法正确执行find()、update()、delete()及insertGetId()等操作。以下是配置主键名称的具体方法：
一、在模型类中显式声明$pk属性
ThinkPHP 6 要求主键字段名必须在模型类内部以protected $pk形式显式声明，该设置不会从配置文件或运行时动态赋值生效，且不兼容 ThinkPHP 5 的$_pk写法。
1、打开对应模型类文件，例如app\model\User.php。
2、在类定义内部添加protected $pk = 'user_id';语句，其中user_id需与数据库实际主键字段名完全一致（区分大小写，不自动转换）。
立即学习“PHP免费学习笔记（深入）”；
3、确保该语句位于class User extends Model {花括号内，且未被注释或置于方法内部。
4、保存文件后，调用User::find(1001)将生成WHERE user_id = 1001而非WHERE id = 1001的SQL语句。
二、使用$primaryKey属性兼容旧习惯写法
尽管$pk是TP6推荐写法，但框架仍保留对$primaryKey属性的支持，二者功能等价，可任选其一使用，不可同时声明。
1、在模型类中删除已有的$pk定义（如有）。
2、添加protected $primaryKey = 'order_sn';，字段名须与数据库中主键列名严格一致。
3、验证Order::where('status', 'paid')->find()返回结果是否基于order_sn字段完成主键定位。
4、注意：若同时定义$pk和$primaryKey，框架仅识别$pk，后者被忽略。
三、针对自增主键字段配置$auto标识
当主键字段具备数据库级自增特性（如MySQL的AUTO_INCREMENT），但字段名非id时，仅设$pk不足以使insertGetId()正常返回插入ID，必须同步启用$auto标记。
1、确认数据库中目标字段（如log_id）已设置为AUTO_INCREMENT（MySQL）或SERIAL（PostgreSQL）。
2、在模型类中同时声明：protected $pk = 'log_id';与protected $auto = true;。
3、执行$result = LogModel::create(['content' => 'test']);后，$result->log_id和LogModel::getLastInsID()将返回真实插入的自增数值。
4、若未设置$auto = true，insertGetId()将尝试读取id字段并返回0或null。
四、禁用时间戳自动写入避免干扰
当主键非id且表中存在create_time或update_time等时间戳字段时，若未关闭自动写入，可能引发字段冲突或主键识别异常。
1、检查模型中是否启用了时间戳功能，如存在protected $autoWriteTimestamp = true;或类似配置。
2、在声明$pk的同时，显式关闭时间戳自动写入：protected $autoWriteTimestamp = false;。
3、如确需时间戳字段，改用protected $createTime = 'create_time';和protected $updateTime = 'update_time';单独指定字段名。
4、此步骤可防止框架在INSERT语句中错误填充id字段值，保障主键字段独立承载唯一标识逻辑。
