Doctrine迁移执行失败：SQL空值错误排查求助

问题定位 #

你的报错SQLSTATE[22004]: Null value not allowed: 1138 Invalid use of NULL value，核心原因是迁移文件中将users表的reset_token字段设为NOT NULL，但数据库中该字段已有NULL值。实体里设置默认值为NULL不影响数据库现有数据，修改约束时数据库会检查已有数据，存在NULL就会触发错误。和你在Orders实体添加的cascade: ["persist"]关联配置无关，先聚焦处理users表的字段问题。

解决步骤 #

• 方案一：手动预处理数据后执行迁移

  1. 直接登录数据库执行SQL，把所有NULL的reset_token替换为非空值（比如空字符串）：

     UPDATE users SET reset_token = '' WHERE reset_token IS NULL;
     

  2. 重新执行Doctrine迁移命令：php bin/console doctrine:migrations:migrate

• 方案二：修改迁移文件自动处理数据

  1. 打开DoctrineMigrations\Version20231003115032迁移文件
  2. 在修改reset_token字段为NOT NULL的代码前，添加数据更新的SQL语句：

     public function up(Schema $schema): void
     {
         // 先处理现有NULL数据
         $this->addSql('UPDATE users SET reset_token = \'\' WHERE reset_token IS NULL;');
         // 原有的修改字段约束代码
         $this->addSql('ALTER TABLE users CHANGE reset_token reset_token VARCHAR(255) NOT NULL;');
         // 其他迁移代码（比如categories表的外键修改）
     }
     

  3. 保存后重新执行迁移命令

额外检查 #

• 完成users表的处理后，再验证categories表的外键约束修改：确保外键关联的字段没有NULL值，若有类似问题，同样先预处理数据再修改约束。
• 关于Orders实体的cascade: ["persist"]，迁移完成后测试订单创建/保存流程，确认关联实体能正常持久化，避免后续出现关联数据的Null问题。

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