#[ApiResource]加了却没生成端点，最常见原因是实体类缺少必要元数据或违反隐式规则：必须是Doctrine管理的实体、主键为id且类型为int/string、字段需#[Groups]才序列化、禁用默认构造函数会导致反序列化失败。
API Platform 能直接生成可运行的 RESTful API，但前提是实体类定义必须严格符合它的契约——不是“写个 Doctrine Entity 就能用”，而是字段类型、注解、序列化组这些细节决定它是否暴露为资源、能否自动校验、是否支持分页或过滤。
为什么 #[ApiResource] 加了却没生成端点
最常见的原因是实体类缺少必要元数据或违反了 API Platform 的隐式规则。
-
#[ApiResource]必须加在 Doctrine 实体类上，且该类需被 Doctrine 管理（即配置了@ORM\Entity和@ORM\Table） - 主键字段必须是
id，且类型为int或string；若用 UUID，需显式声明#[Id]并确保生成器兼容 - 字段若未加
#[Groups]注解，默认不会序列化——GET 返回空对象、POST 提交会报 400 “This field was not expected” - 如果用了自定义构造函数或禁用了默认构造函数，
ApiPlatform的反序列化器会失败，报Cannot instantiate entity
PUT 和 PATCH 行为不一致的根源
API Platform 默认把 PUT 当作全量替换，PATCH 当作部分更新，但这个行为依赖于序列化组和验证约束，不是 HTTP 方法本身决定的。
-
PUT请求会尝试覆盖所有带write组的字段，哪怕请求体里没传——缺失字段会被设为null或触发验证失败 -
PATCH只处理请求体中实际出现的字段，但前提是这些字段在write组里，且没被@Assert\NotNull等强制非空约束挡住 - 想让
PATCH允许部分更新，得在属性上加#[Assert\NotNull(groups: ['patch'])]，并在#[ApiResource]中指定inputFormats: ['json' => ['patch' => 'application/merge-patch+json']]（可选）
数据库字段变更后 API 不同步的典型表现
Doctrine 迁移执行了，但 API 响应里还是旧字段，或者新增字段根本不出现在 Swagger UI 里——这不是缓存问题，而是 API Platform 的元数据缓存没刷新。
- 修改实体后，必须清空 Symfony 的
cache:clear，否则ApiResource元数据仍读取旧版本 - 若用
make:entity添加字段，它默认不加#[Groups]，新字段不会出现在 API 中 - 删除字段后，旧客户端仍可能发送该字段，API Platform 默认忽略未知字段；如需报错，得启用严格模式：
serializer: { enable_max_depth: true }并配合#[Ignore]控制
真正卡住人的地方往往不在“怎么加注解”，而在“哪个注解在哪个上下文生效”——比如 #[Groups] 控制序列化，#[Assert] 控制验证，#[ApiFilter] 控制查询参数，三者作用域不同，混用时容易漏掉一环。调试时优先看 php bin/console debug:api 输出的实际资源定义，比猜更可靠。
