Symfony 5 Api-Platform 自定义序列化上下文不生效致创建用户报错
问题根因
导致反序列化逻辑失效的原因是两个非常容易踩的注解配置坑,没有复杂逻辑:
- 注解配置键名写法错误,自定义配置被静默丢弃
Api Platform 的@ApiResource注解由 Doctrine 注解解析器加载,所有配置键必须严格使用驼峰命名匹配注解类的属性定义。如果你写成蛇形命名,解析器会直接忽略这些配置,不会抛出任何明显的报错。
你在POST、PUT操作里写的denormalization_context、normalization_context都是蛇形写法,对应的正确键名是denormalizationContext、normalizationContext。因为这部分配置被丢弃,POST操作根本没有加载你指定的POST反序列化分组,而是混乱继承了全局normalization的配置逻辑,最终导致所有请求传入的参数都无法映射到实体属性上。 - 全局缺失反序列化上下文兜底规则
你只在注解顶层配置了normalizationContext的GET分组,没有配置全局的denormalizationContext做兜底。一旦子操作的自定义配置失效,反序列化的组过滤逻辑就会出现混乱,最终触发全部的NotBlank校验。
修正方法
把注解里所有蛇形写法的配置键替换为驼峰写法,同时补充顶层的全局反序列化兜底配置,调整后的核心注解参考:
/** * @ApiResource( * normalizationContext={"groups"={"GET"}}, * denormalizationContext={"groups"={"POST"}}, // 新增兜底配置 * itemOperations={ * "GET"={ * "security"="is_granted('IS_AUTHENTICATED_FULLY')", * "normalizationContext"={ // 修正为驼峰写法 * "groups"={"GET"} * } * }, * "PUT"={ * "security"="is_granted('IS_AUTHENTICATED_FULLY') and object === user", * "denormalizationContext"={ // 修正为驼峰写法 * "groups"={"PUT"} * } * } * }, * collectionOperations={ * "POST"={ * "denormalizationContext"={ // 修正为驼峰写法 * "groups"={"POST"} * } * } * } * ) */
修改完成后执行php bin/console cache:clear清空注解缓存,再测试POST创建用户的接口就可以正常完成反序列化和校验流程。
排查提醒
很多教程在演示Api Platform资源配置时会使用YAML或XML格式,这类配置文件里的键是蛇形写法,不要把这个习惯套用到PHP注解配置上——注解解析器是严格按照驼峰键名做匹配的,蛇形键会被静默忽略,往往排查很久都找不到原因。
内容的提问来源于stack exchange,提问作者Shubham Kumar
相关产品推荐
相关产品推荐

