ThinkPHP模型新增数据保存失败通常由数据合法性、模型字段权限、字段缓存及运行环境四方面问题导致：数据为空或字段名不匹配；未启用allowField(true)或schema未包含新字段；DB_FIELDS_CACHE未关闭致缓存未更新；Linux下runtime目录缺执行权限阻碍缓存生成。
ThinkPHP模型新增数据保存失败，通常不是单一原因导致的，而是多个环节配合出错。排查时建议从数据、模型、配置、环境四个层面入手，逐项验证，避免盲目清缓存或重启。
检查传入数据是否合法且完整
新增操作依赖有效数据，常见问题包括：
- 数据为空数组或未传递任何字段，save() 或 add() 将直接返回 false 或 0
- 关键字段缺失，比如设置了主键自增但误传了 id 值（尤其在 TP6+ 中可能触发主键冲突）
- 字段名与数据库实际列名不一致，例如用下划线命名的表字段写成驼峰（
user_name写成userName） - 使用
$this->request->param()获取参数时混入了 URL 路由变量，导致非法字段被当作数据传入（报错如not support data:admin/goods/add），应改用$this->request->post()
确认模型调用方式和字段权限
TP5/6 中模型新增默认走 save()，但行为受显式控制影响：
- 未设置
allowField(true)时，模型只接受在$schema或数据库中明确声明的字段，新增字段会被过滤 - 若模型中定义了
protected $schema = [...]，但未包含新字段，该字段将被忽略——此时即使数据库有该列，也不会写入 - 使用
M('User')->add($data)时，框架不会自动校验字段，但字段名错误或类型不匹配仍会导致 SQL 执行失败（如插入 NULL 到非空字段）
排查字段缓存与运行时环境
字段结构变更后保存异常，大概率是缓存未更新：
立即学习“PHP免费学习笔记（深入）”；
- TP 默认开启字段缓存（
DB_FIELDS_CACHE => true），会把表结构信息存入runtime/Data/_fields/下的 PHP 文件 - 添加新字段后未清除缓存，模型仍按旧结构读取字段，导致新增字段被丢弃
- Linux 部署时，
runtime目录缺少执行权限（x），PHP 无法进入子目录创建缓存文件，表现为“字段信息读取失败”或静默丢字段 - 解决方法：手动删除
runtime/Data/_fields/全部文件；或在配置中设'DB_FIELDS_CACHE' => false（开发阶段推荐）
启用调试并检查底层 SQL
光看返回值容易误判，必须观察真实执行过程：
- 开启数据库调试：
'DB_DEBUG' => true，查看日志中生成的 INSERT 语句是否含目标字段、值是否符合预期 - 检查返回值含义：TP 的
save()新增成功返回主键值（数字），失败返回false；add()同理，不要用if($res)判断，而要用if($res !== false) - 若 SQL 明确报错（如 “Unknown column”、“Data too long”），说明字段名、长度或类型不匹配，需对照数据库表结构逐项核对
