Symfony3.4多对多关联报错：shopping_list_id字段不能为空

哦，这个坑我太熟了——你直接用原生SQL插入shopping_row的时候，传了null作为shopping_list_id，而数据库里这个字段是被设置为非空的，自然会触发完整性约束错误。更关键的是，你完全绕开了Doctrine为关联实体设计的持久化逻辑，这才是问题的核心。

问题根源 #

你执行INSERT语句时，shopping_list_id传null，是因为对应的ShoppingList实体还没被保存到数据库，根本没有生成有效的主键ID。而数据库里shopping_list_id是外键且不允许为空（从报错和你的关联设计来看），所以直接插肯定失败。

正确的解决方式：用Doctrine关联映射处理，别手动写SQL #

既然你已经设计了ShoppingList（一对多）→ShoppingRow（多对一）→Fruit的关联结构，就该让Doctrine帮你处理关联数据的持久化，而不是自己写原生SQL。

第一步：确认你的实体映射配置正确

先检查三个实体的关联注解是否正确，尤其是cascade和JoinColumn的设置：

ShoppingList实体的一对多关联

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class ShoppingList
{
    // ... 其他字段和getter/setter

    /**
     * @ORM\OneToMany(targetEntity="ShoppingRow", mappedBy="shoppingList", cascade={"persist"})
     */
    private $shoppingRows;

    public function __construct()
    {
        $this->shoppingRows = new ArrayCollection();
    }

    // 添加ShoppingRow的方法，一定要关联双向关系
    public function addShoppingRow(ShoppingRow $shoppingRow): self
    {
        if (!$this->shoppingRows->contains($shoppingRow)) {
            $shoppingRow->setShoppingList($this); // 关键：设置ShoppingRow的关联
            $this->shoppingRows->add($shoppingRow);
        }
        return $this;
    }

    public function removeShoppingRow(ShoppingRow $shoppingRow): self
    {
        if ($this->shoppingRows->removeElement($shoppingRow)) {
            // 断开双向关联
            if ($shoppingRow->getShoppingList() === $this) {
                $shoppingRow->setShoppingList(null);
            }
        }
        return $this;
    }

    // getter for shoppingRows
    public function getShoppingRows()
    {
        return $this->shoppingRows;
    }
}

ShoppingRow实体的多对一关联

/**
 * @ORM\Entity
 */
class ShoppingRow
{
    // ... 其他字段和getter/setter

    /**
     * @ORM\ManyToOne(targetEntity="ShoppingList", inversedBy="shoppingRows")
     * @ORM\JoinColumn(name="shopping_list_id", nullable=false) // 这里nullable=false确保字段非空
     */
    private $shoppingList;

    /**
     * @ORM\ManyToOne(targetEntity="Fruit")
     * @ORM\JoinColumn(name="fruit_id", nullable=false)
     */
    private $fruit;

    /**
     * @ORM\Column(type="integer")
     */
    private $quantity;

    // setter方法
    public function setShoppingList(ShoppingList $shoppingList): self
    {
        $this->shoppingList = $shoppingList;
        return $this;
    }

    public function setFruit(Fruit $fruit): self
    {
        $this->fruit = $fruit;
        return $this;
    }

    public function setQuantity(int $quantity): self
    {
        $this->quantity = $quantity;
        return $this;
    }

    // 对应的getter方法...
}

第二步：在newAction中正确创建并持久化关联实体

把你手动写SQL的逻辑换成Doctrine的持久化流程，它会自动帮你处理shopping_list_id的填充：

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;
use Doctrine\ORM\EntityManagerInterface;
use App\Entity\ShoppingList;
use App\Entity\ShoppingRow;
use App\Entity\Fruit;

class ShoppingListController extends Controller
{
    public function newAction(Request $request, EntityManagerInterface $em)
    {
        // 1. 创建ShoppingList实例
        $shoppingList = new ShoppingList();
        // 这里可以设置ShoppingList的其他属性，比如name等

        // 2. 获取要关联的Fruit实例（假设id=11的Fruit存在）
        $fruit = $em->getRepository(Fruit::class)->find(11);
        if (!$fruit) {
            throw $this->createNotFoundException('指定ID的水果不存在');
        }

        // 3. 创建ShoppingRow并设置属性和关联
        $shoppingRow = new ShoppingRow();
        $shoppingRow->setQuantity(1);
        $shoppingRow->setFruit($fruit);
        // 把ShoppingRow关联到ShoppingList
        $shoppingList->addShoppingRow($shoppingRow);

        // 4. 持久化ShoppingList，Doctrine会自动处理ShoppingRow的插入
        $em->persist($shoppingList);
        $em->flush(); // 这里会先插入ShoppingList拿到ID，再插入ShoppingRow并填充shopping_list_id

        // 5. 跳转或返回响应
        return $this->redirectToRoute('shopping_list_show', [
            'id' => $shoppingList->getId()
        ]);
    }
}

为什么手动SQL不行？ #

当你直接执行INSERT时，ShoppingList还没被保存到数据库，没有生成主键ID，所以你只能传null给shopping_list_id，但数据库里这个字段被设置为非空（nullable=false），自然触发报错。而用Doctrine的关联逻辑，flush()时会先插入ShoppingList获取到它的ID，然后再插入ShoppingRow，自动把这个ID填充到shopping_list_id字段，完全避开了null的问题。

小提醒 #

在Symfony/Doctrine项目中，除非是特别复杂的统计类查询，否则尽量用实体和关联映射来操作数据库，原生SQL很容易破坏ORM的一致性，也容易出现这类约束错误。

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