MySQL TINYINT(4)列设默认值0却存NULL的问题排查求助

咱们一步步拆解问题的可能成因和排查方法——既然你提到有个配置逻辑完全相同的列能正常工作，对比这两个列的差异会是关键突破口。

1. 确认列的默认值是否真正生效 #

你说已经把列的默认值更新为0，但首先要验证这个修改是否真的落到了表结构上。有时候ALTER TABLE语句可能因为语法问题没执行成功，或者你操作的不是目标表。

执行这条命令查看表的完整定义：

SHOW CREATE TABLE your_table_name;

找到目标列的定义，重点核对这几个部分：

• DEFAULT后面是不是明确写的0（注意是数值0，不是字符串'0'，虽然MySQL会做隐式转换，但数值型列用数值默认值更稳妥）
• NULL属性是YES还是NO——如果是YES，说明列允许NULL，当代码显式传入NULL时，MySQL会优先存NULL而不是用默认值；如果是NO，就会触发你遇到的报错

同时对比那个正常工作的列，确认两者的定义完全一致，包括数据类型、默认值、NULL约束。

2. 检查代码的字段赋值逻辑 #

这是最常见的问题：代码里可能在显式传递NULL给这个列，而不是省略该字段。

MySQL只有在INSERT/UPDATE语句中没有指定该列的时候，才会使用默认值。如果代码里明确写了column_name = NULL，哪怕列有默认值，也会存NULL；如果列加了NOT NULL约束，就会直接报错。

你可以这么排查：

• 对比正常列和有问题列的代码处理逻辑：正常列是不是在保存时没有给字段赋值（让框架自动省略该列），而有问题的列被代码主动设置成了NULL？
• 开启SQL日志，查看实际执行的INSERT语句：看看有问题的列是不是出现在INSERT字段列表里，并且值是NULL；而正常列没有出现在字段列表中，所以触发了默认值。
• 如果用了ORM框架（比如MyBatis、Hibernate），检查动态SQL的判断逻辑：比如是不是有if test="column != null"这样的判断，但代码里把这个字段设成了null，导致条件不成立？或者反过来，判断条件写错了，导致即使字段为null也被加入到INSERT语句中？

3. 排查MySQL的SQL_MODE设置 #

MySQL的SQL_MODE会影响默认值的行为，尤其是严格模式（STRICT_TRANS_TABLES）。

执行这条命令查看当前SQL_MODE：

SELECT @@SQL_MODE;

如果开启了STRICT_TRANS_TABLES，当你尝试插入NULL到允许NULL的列时，会直接存NULL（不会触发默认值）；如果列是NOT NULL，就会抛出错误。

而那个正常的列，可能是因为代码没有显式传值，所以不管SQL_MODE如何，都会使用默认值。你可以对比两个列的INSERT语句差异，确认是不是有问题的列被显式传了NULL。

4. 检查触发器或数据库事件 #

有没有可能存在BEFORE INSERT/UPDATE触发器，在数据保存前修改了这个列的值？比如某个触发器把该列设为NULL，而正常的列没有对应的触发器。

执行这条命令查看表的触发器：

SHOW TRIGGERS LIKE 'your_table_name';

检查有没有针对目标列的触发器逻辑，看看是不是它在干扰值的设置。

5. 验证存储引擎与MySQL版本一致性 #

虽然你说配置逻辑相同，但还是要确认两个列所在的表是不是用的同一个存储引擎（比如都是InnoDB），以及MySQL版本是否一致。不同存储引擎或版本在默认值处理上可能有细微差异，但这个可能性相对较低，可以作为最后排查的点。

总结一下：最可能的原因是代码显式传递了NULL给该列，或者列的默认值设置没有真正生效。对比正常列和有问题列的表结构、代码逻辑、执行的SQL语句，应该能快速定位问题。

内容的提问来源于stack exchange，提问作者Zach Smith