ThinkPHP模型主键必须在模型类中显式声明protected $pk属性，严格匹配数据库字段名；自增主键需额外设置protected $auto = true；TP8还需声明protected $pkType类型。

ThinkPHP模型主键必须在模型类里显式声明，不能靠配置文件、动态调用或旧写法生效。默认只认 id 字段，如果数据库主键是 user_id、order_no 或其他名称，不设就会查不到数据、删错记录、拿不到新增ID。

TP6/TP8 必须写 $pk 属性

在模型类中添加一行：

• protected $pk = 'user_id'; —— 字符串形式，严格匹配数据库字段名（大小写、下划线都不能错）
• 不能写成 userId、USER_ID 或数组；不支持复合主键自动识别
• TP5 的 $_pk 已废弃，写了也无效，必须改成 $pk

自增主键要额外配 $auto = true

如果主键是自增的（比如 log_id），仅设 $pk 不够，insertGetId() 还是返回 0：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 必须同时加 protected $auto = true;
• 确保数据库该字段确实是 AUTO_INCREMENT（MySQL）或 SERIAL（PostgreSQL）
• 避免时间戳干扰：若启用了自动写入时间戳，建议关掉 $autoWriteTimestamp = false

TP8 要补充 $pkType 类型声明

TP8 对参数类型更严格，主键类型不声明会导致 find(1) 查不到、关联失效且无提示：

• 数字型主键：protected $pkType = 'int';
• 字符串型主键（如 UUID、订单号）：protected $pkType = 'string';
• 类型声明紧接在 $pk 后面，顺序无关但建议放一起

别踩这些坑

常见错误不是语法问题，而是配置被忽略：

• 在 Db::table() 链式调用里用 ->pk('uid') —— TP6/TP8 不支持这种动态指定
• 把 $pk 写在配置文件或构造方法里 —— 只有类属性 protected $pk 生效
• 多库项目误以为能全局统一设主键 —— 每个模型的 $pk 是独立的，需逐个定义
• 升级 TP5 → TP6 后没清理 $_pk、$_auto 等旧属性 —— 全部删掉重写

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！