Api Platform：更新注解格式后匿名ODM文档弃用警告修复问询

问题核心 #

你遇到的警告来自API Platform 2.7的版本调整：3.0开始会默认给匿名资源生成Skolem IRI，而你的Brands、Companies是未注册为API资源的MongoDB ODM匿名文档集合，每条集合条目都会触发该警告。

修复方案 #

方案1：给匿名文档类添加属性注解 #

不要仅在Account类的$brands/$companies属性上加注解，需直接在Brands和Companies这两个匿名文档的类本身添加#[ApiProperty(genId: false)]：

<?php

use ApiPlatform\Metadata\ApiProperty;

#[ApiProperty(genId: false)]
class Brands
{
    // 文档属性与方法
}

#[ApiProperty(genId: false)]
class Companies
{
    // 文档属性与方法
}

警告是针对每个匿名文档实例触发的，注解必须作用到文档类本身，而非父类的关联属性。

方案2：将嵌套文档注册为完整API资源（可选） #

如果后续需要对Brands/Companies提供独立API操作，可以把它们注册为正式API资源：

<?php

use ApiPlatform\Metadata\ApiResource;

#[ApiResource]
class Brands
{
    // 类内容
}

注册后它们不再属于匿名资源，警告会自动消失。

方案3：临时抑制警告（不推荐生产环境） #

若仅需临时消除警告，可在配置中抑制该特定弃用提示：
在config/packages/api_platform.yaml中添加：

api_platform:
    serializer:
        deprecations: false

或在入口文件中调整错误报告级别：

// public/index.php 或 config/bootstrap.php
error_reporting(E_ALL ^ E_USER_DEPRECATED);

此方案仅作临时过渡，建议优先用方案1或2适配新版本规范。

验证步骤 #

1. 添加注解后执行缓存清除：php bin/console cache:clear --env=prod（根据运行环境调整参数）
2. 重新调用/api/accounts接口，检查日志确认警告是否消失

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