根本原因是模型层与数据库层默认值策略未对齐：数据库设了default但模型未配置default，或模型default被空字符串绕过；需先用原始sql测试确认是否tp写入，再清缓存、查字段、验模型配置三步排查。
ThinkPHP项目上线后新增数据库字段，但插入数据时该字段始终写入NULL或触发NOT NULL约束报错，根本原因常被误判为代码逻辑问题，实际是模型层与数据库层默认值策略未对齐——字段在数据库中设了DEFAULT，但模型没做对应处理，或模型default配置被空字符串绕过。
确认字段是否真的被写入数据库
执行一条原始SQL插入测试：Db::execute("INSERT INTO user (name, email) VALUES ('test', 't@t.com')"); 查看新增字段值。若此时字段存的是数据库默认值（如CURRENT_TIMESTAMP），说明TP未干预该字段；若存NULL或0000-00-00，则证明模型层跳过了它，需检查字段缓存和模型配置。
这一步必须做，否则所有后续排查都在假定“是TP写的”，而实际可能是数据库自己填的。
清空字段缓存并验证表结构
删除 Runtime/Data/_fields/ 目录下对应模型的缓存文件，例如 user.php 或 user_fields.php；没有就删整个 _fields 文件夹。
【务必重启Web服务或至少刷新一次页面再测试】 —— ThinkPHP在首次加载模型时会重新扫描表结构并生成新缓存，不重启可能仍读旧缓存。
用 Db::getFields('user') 打印当前识别到的字段列表，确认新增字段名已出现在返回数组中。如果没出现，说明数据库表结构未被正确识别，检查MySQL用户权限或表名大小写是否匹配。
模型default配置生效的三个硬性前提
第一步：确保字段在数据库中允许为NULL，或已设置DEFAULT约束。NOT NULL且无DEFAULT的字段，TP模型default不会覆盖数据库校验。
第二步：模型中 $default 配置仅对「完全未传」或「显式赋值为null」生效；若前端传了 ''、0、false，default直接被跳过。例如：$default = ['status' => 1]，当请求带 "status": ""，最终入库仍是空字符串，不是1。
第三步：字段类型必须与 default 值兼容。数据库是 TINYINT(1)，模型写 'status' => 'enable' 会强制转为0；数据库是 DATETIME，却写 'create_time' => time()（整数），TP类型转换失败后静默丢弃该字段，结果存NULL。
空字符串绕过default的应急过滤方案
方法一：在控制器接收参数后立即过滤
$data = array_filter($this->request->param(), function($v) { return $v !== ''; });
方法二：在模型 save() 前统一清理
public function save($data = [], $sequence = null) { $data = array_map(function($v) { return $v === '' ? null : $v; }, $data); return parent::save($data, $sequence); }
注意：此操作会把所有空字符串转为null，从而触发default逻辑，但也会丢失业务上“明确传空”的语义，慎用于如 nickname='' 这类合法空值场景。
真正可靠的动态默认值写法
在模型中注册 before_write 事件，手动控制字段赋值：
protected $event = ['before_write' => 'setDynamicDefaults'];
public function setDynamicDefaults() { if (!isset($this->data['uuid'])) { $this->data['uuid'] = \think\helper\Str::uuid(); } if (!isset($this->data['create_user_id'])) { $this->data['create_user_id'] = \think\facade\Auth::id() ?: 0; } }
这个方法能访问完整模型实例和运行时上下文，且在 saveAll 批量插入时每条记录都独立执行，不会复用闭包结果。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
