Lumen集成Doctrine时报实体未指定主键错误的原因咨询

问题场景 #

在Lumen项目中集成Doctrine ORM时，编写了App\Entity\Customers实体类，执行持久化操作时触发错误：

No identifier/primary key specified for Entity "App\Entity\Customers". Every Entity must have an identifier/primary key.

错误原因 #

你的实体类存在两个关键问题：

• 未导入Id和GeneratedValue这两个Doctrine属性映射类，当前仅导入了Column、Entity、Table
• 错误使用#[ORM\Id]写法，但代码里并未引入ORM命名空间别名

Doctrine无法识别未正确导入的主键属性，因此判定实体未设置主键。

修正后的实体类代码 #

<?php

namespace App\Entity;

// 补充导入Id和GeneratedValue映射类
use Doctrine\ORM\Mapping\Column;
use Doctrine\ORM\Mapping\Entity;
use Doctrine\ORM\Mapping\GeneratedValue;
use Doctrine\ORM\Mapping\Id;
use Doctrine\ORM\Mapping\Table;
use Doctrine\DBAL\Types\Types;

#[Entity]
#[Table(name: 'customers')]
class Customers
{
    // 修正为导入的Id注解类
    #[Id]
    #[Column(type: 'integer')]
    #[GeneratedValue]
    private int|null $id=null;

    #[Column(type: Types::STRING)]
    private string $first;

    #[Column(type: Types::STRING)]
    private string $last;

    #[Column(type: Types::STRING)]
    private string $email;

    #[Column(type: Types::STRING)]
    private string $phone;

    #[Column(type: Types::STRING)]
    private string $gender;

    #[Column(type: Types::STRING)]
    private string $username;

    #[Column(type: Types::STRING)]
    private string $password;

    #[Column(type: Types::STRING)]
    private string $city;

    #[Column(type: Types::STRING)]
    private string $country;
}

补充说明 #

根据Doctrine属性映射规则，所有实体映射注解都需从Doctrine\ORM\Mapping命名空间导入，直接使用注解类名（不带前缀）。如果想用#[ORM\XXX]的别名写法，需要先为命名空间设置别名：

use Doctrine\ORM\Mapping as ORM;
use Doctrine\DBAL\Types\Types;

#[ORM\Entity]
#[ORM\Table(name: 'customers')]
class Customers
{
    #[ORM\Id]
    #[ORM\Column(type: 'integer')]
    #[ORM\GeneratedValue]
    private int|null $id=null;
    // ... 其他属性
}

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