ApiPlatform 3.1.13关联实体外键非空约束错误求助

问题根源 #

你遇到的SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'shopping_list_id' cannot be null错误，核心原因有三个：

1. ItemShoppingList的关联字段未加入序列化组：$shoppingList字段未标记#[Groups('serialize')]，ApiPlatform反序列化时无法接收关联数据，无法自动设置外键。
2. 缺少嵌套POST路由：当前仅为ItemShoppingList配置了嵌套的GetCollection路由，没有嵌套POST操作，无法通过URL参数自动关联ShoppingList。
3. ShoppingList集合未初始化：构造函数中注释了集合初始化代码，导致$items为null，可能引发隐性错误。

具体修复方案 #

方案1：添加嵌套POST路由（推荐） #

修改ItemShoppingList的ApiResource配置，新增嵌套POST操作，让ApiPlatform自动从URL参数获取并关联ShoppingList：

#[ApiResource(
    paginationEnabled: false,
    uriTemplate: '/shopping_lists/{id}/item_shopping_lists',
    uriVariables: [
        'id' => new Link(fromClass: ShoppingList::class, toProperty: 'shoppingList'),
    ],
    operations: [
        new GetCollection(),
        new Post() // 添加该POST操作
    ]
)]
#[ApiResource(
    paginationEnabled: false,
    normalizationContext: ['groups' => ['serialize']],
    denormalizationContext: ['groups' => ['serialize']],
)]
#[ORM\Entity(repositoryClass: ItemShoppingListRepository::class)]
class ItemShoppingList
{
    // 其他代码保持不变
}

此后通过POST /shopping_lists/{购物清单ID}/item_shopping_lists接口创建条目时，ApiPlatform会自动将shopping_list_id设为URL中的ID，无需前端额外传入关联数据。

方案2：将shoppingList字段加入序列化组 #

若需允许前端直接通过POST /item_shopping_lists创建条目，给$shoppingList字段添加序列化组：

#[ORM\ManyToOne(inversedBy: 'items')]
#[ORM\JoinColumn(nullable: false)]
#[Groups('serialize')] // 添加该行
private ?ShoppingList $shoppingList = null;

前端请求时可传入ShoppingList的IRI（如"/shopping_lists/1"）或直接传ID，ApiPlatform会自动处理关联：

{
  "name": "测试商品",
  "isChecked": false,
  "position": 1,
  "shoppingList": "/shopping_lists/1"
}

方案3：修复ShoppingList集合初始化 #

取消ShoppingList构造函数中集合初始化的注释，避免集合为null引发隐性问题：

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

验证修复 #

完成修改后，按需生成并执行数据库迁移，测试对应POST接口即可解决外键为空的问题。

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