Symfony 6执行数据库迁移时遇非空约束错误求助

学习Symfony 6安全教程时，创建了以email作为唯一标识的User类，执行symfony console doctrine:migration:migrate命令进行数据库迁移时，触发如下错误：

exception occurred while executing a query: SQLSTATE[23502]: Not null violation: 7 ERROR:  column "email" of relation "user" contains null values"

In ExceptionConverter.php line 47:

  An exception occurred while executing a query: SQLSTATE[23502]: Not null violation: 7 ERROR:  column "email" of relation "user" contains null values


In Exception.php line 28:

  SQLSTATE[23502]: Not null violation: 7 ERROR:  column "email" of relation "user" contains   null values


In Connection.php line 70:

  SQLSTATE[23502]: Not null violation: 7 ERROR:  column "email" of relation "user" contains   null values 

请问该问题的根源是什么？是否需要手动修改生成的代码？

问题根源 #

• 现有数据违反约束：你的user表中已经存在email字段为NULL的记录，而你定义的User类给email加上了非空约束，数据库执行迁移时检查到冲突，抛出非空违反错误。
• 迁移文件未处理默认值：如果是新增email字段的迁移，Doctrine不会自动为已有记录填充email值，导致NULL值触发非空约束。

解决办法 #

场景1：可清空现有测试数据 #

执行以下命令清空user表数据（注意：会删除所有用户数据，谨慎操作）：

symfony console doctrine:query:sql "TRUNCATE TABLE user CASCADE"

之后重新运行迁移命令即可。

场景2：需要保留现有数据 #

1. 修改迁移文件：找到生成的迁移文件，在添加email字段的SQL语句中加入默认值，示例：

// 迁移文件中的addColumn语句
$this->addSql('ALTER TABLE user ADD email VARCHAR(180) NOT NULL DEFAULT \'\'');

2. 补充现有数据：执行迁移后，通过SQL语句为现有用户填充真实的email值：

UPDATE user SET email = 'your-default-email@example.com' WHERE email = '';

3. 可选：移除默认值：如果不需要默认值，可再生成一次迁移，修改email字段去掉默认值。

关于是否修改User类代码 #

不需要修改User类的核心代码（除非你原本的注解/配置有误，比如漏加了非空约束），问题核心是解决数据库现有数据与新约束的冲突，调整迁移文件即可。

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