Symfony/EasyAdmin新增图书报SQLSTATE[23502]非空约束错误如何解决？

错误原因 #

这个非空约束报错的核心是Book实体中Genre关联字段设置了nullable=false，要求保存图书时必须绑定已存在的Genre分类实体，但你现在的实体定义存在冗余字段冲突，且保存逻辑没有正确给关联字段赋值，导致genre_id外键列为空触发报错。

解决方案 #

第一步：删除冗余字段，修正实体定义 #

你当前Book实体里同时定义了两个和分类相关的属性：字符串类型的$genre字段、关联Genre实体的$Genre字段，属于重复定义。Doctrine会自动为$Genre关联生成genre_id外键列，你额外定义的$genre字符串字段毫无作用，还会导致赋值混淆，直接删除以下代码：

/**
* @ORM\Column(type="string", length=255)
*/
private $genre;

删除后执行命令更新数据库结构：

php bin/console make:migration
php bin/console doctrine:migrations:migrate

第二步：正确给关联字段赋值 #

Symfony的Doctrine ORM处理关联时，不能直接给关联字段传分类ID或者分类名称，必须传入查询到的Genre实体对象，示例代码如下：

// 先根据传入的分类ID查询到对应的Genre实体
$targetGenre = $entityManager->getRepository(Genre::class)->find($request->get('genre_id'));
// 给Book实体的Genre属性赋值
$book->setGenre($targetGenre);
// 再执行保存操作
$entityManager->persist($book);
$entityManager->flush();

如果你是用Symfony表单组件创建图书表单，需要把分类字段修改为EntityType类型，不要用普通的文本/数字输入框：

// 在BookType类的buildForm方法中调整配置
$builder->add('Genre', EntityType::class, [
    'class' => Genre::class,
    'choice_label' => 'name', // 替换为你Genre实体中分类名称对应的属性名
]);

可选调整：允许图书无分类 #

如果你的业务允许图书可以不绑定分类，只需要把@ORM\JoinColumn(nullable=false)中的nullable参数改为true，再执行迁移更新数据库即可。

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