在 symfony 6.4 中创建实体类需先定义带 doctrine 映射元数据的 php 类以描述数据库表结构，必须在执行迁移前完成；可通过 make:entity 交互式生成，或手动在 src/entity/ 下创建并添加 @orm\entity 等注解。
在 Symfony 6.4 中创建实体类，本质是定义一个带 Doctrine 映射元数据的 PHP 类，用于描述数据库表结构及字段行为，这一步必须在执行迁移前完成，否则生成的迁移文件将为空。
用 make:entity 交互式创建
打开终端，进入项目根目录，运行：
php bin/console make:entity
按提示输入实体名称（如 Product），回车后进入字段添加循环；每轮输入字段名→选择类型（如 string、integer、datetime_immutable）→是否允许为 null →是否添加索引或唯一约束；全部完成后输入 【exit】 退出循环。
命令会自动生成 src/Entity/Product.php 和对应的 Repository 类（src/Repository/ProductRepository.php），并自动在实体类中添加 @ORM\Entity 和 @ORM\Table 注解。
若中途输错字段名或类型，直接 Ctrl+C 中断，重新运行命令即可——这一步不会写入任何文件，安全可重试。
手动创建实体类（适合已有表结构或需精细控制）
在 src/Entity/ 目录下新建文件 User.php，内容如下：
```php
namespace App\Entity;
use Doctrine\ORM\Mapping as ORM;
#[ORM\Entity(repositoryClass: UserRepository::class)]
#[ORM\Table(name: 'user')]
class User
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column(type: 'integer')]
private ?int $id = null;
#[ORM\Column(type: 'string', length: 180, unique: true)]
private string $email = '';
public function getId(): ?int
{
return $this->id;
}
public function getEmail(): string
{
return $this->email;
}
public function setEmail(string $email): self
{
$this->email = $email;
return $this;
}
}
```
注意：PHP 8.1+ 属性注解必须使用 #[...] 语法，旧版 @Annotation 写法在 Symfony 6.4 中已不被推荐；若用旧语法，需确保 doctrine/annotations 版本 ≥ 2.0 且配置启用 annotation 驱动。
手动创建后，必须同步创建空的 Repository 类 src/Repository/UserRepository.php，哪怕暂不写方法——否则后续 make:migration 可能跳过该实体。
验证实体是否被 Doctrine 正确识别
第一步：检查 doctrine.yaml 是否启用自动映射
打开 config/packages/doctrine.yaml，确认 entity_managers.default.mappings.App.type 设为 annotation（或 attribute），且 dir 指向 %kernel.project_dir%/src/Entity。
第二步：运行诊断命令
php bin/console debug:config doctrine → 查看输出中 entity_managers.default.mappings 是否包含 App 条目，且其 is_bundle 为 false、dir 值正确；若缺失，说明实体目录未被扫描。
第三步：强制触发元数据加载测试
php bin/console doctrine:schema:validate --skip-sync --dump-sql → 若输出显示 “The mapping files are correct.” 且无 “No mapping files found” 提示，则实体已被识别；若提示 “No metadata found”，说明路径、命名空间或注解语法有误，需回头检查。
生成数据库迁移文件
① 确保数据库连接可用：检查 .env 中 DATABASE_URL 是否指向可写实例（如 sqlite:///%kernel.project_dir%/var/data.db 或 MySQL 地址），【URL 中不能含空格或中文路径】。
② 运行命令生成迁移：
php bin/console make:migration
③ 终端输出类似 “Success! Generated new migration file: migrations/Version20260806105500.php” 即表示成功；若提示 “No changes detected”，请返回上一步验证实体识别状态。
④ 打开生成的迁移文件，确认 up() 方法中包含 $schema->createTable('user') 调用——这是后续 migrate 能建表的关键依据。
