当使用 FOSRestBundle 的 @RequestParam 验证嵌套数据时，若需从校验整个数组（Collection + map=true）切换为校验单个对象，只需将 map=false，使 @Constraints\Collection 直接作用于输入值本身，而非其每个元素。
当使用 fosrestbundle 的 `@requestparam` 验证嵌套数据时，若需从校验整个数组（`collection` + `map=true`）切换为校验单个对象，只需将 `map=false`，使 `@constraints\collection` 直接作用于输入值本身，而非其每个元素。
在 Symfony + FOSRestBundle 场景中，@Constraints\Collection 约束常被误认为专用于“校验数组”，实则它本质是校验关联数组（即键值对结构）的字段规则——无论该结构来自单个对象还是数组中的某一项。关键行为由 map 参数控制：
-
map = true（默认）：将输入视为可遍历集合（如array或Traversable），并对每个元素单独应用Collection约束。适用于你原先的forumsToCreate数组场景。 -
map = false：将输入视为单个原始值，直接将Collection约束应用于该值本身。这正是验证单个嵌套对象（如{ "adminEmail": "...", "forumName": "...", "topic": "..." }）所需的配置。
✅ 正确做法：保持 @Constraints\Collection 不变，仅修改 map 为 false：
/**
* @Rest\RequestParam(
* name="forum",
* key="forum",
* strict=true,
* nullable=true,
* description="Single forum object: { adminEmail: '...', forumName: '...', topic: '...' }",
* requirements=@Constraints\Collection(
* fields={
* "adminEmail": @Constraints\Required({@Constraints\NotBlank(), @Constraints\Email()}),
* "forumName": @Constraints\Optional({@Constraints\NotBlank(), @Constraints\Length(max="255")}),
* "topic": @Constraints\Optional({@Constraints\NotBlank(), @Constraints\Length(max="255")}),
* }
* ),
* map=false // ? 关键！不再遍历，而是直接校验整个输入对象
* )
*/⚠️ 注意事项：
-
map=false时，请求体中forum字段必须是合法的 JSON 对象（非数组、非字符串、非 null），否则会触发类型不匹配错误（如This value should be of type array.）。确保前端发送的是{"forum": {...}}而非{"forum": [{...}]}。 - 若后续需要校验「数组中的每个对象」（例如
forums是对象列表），应改用@Constraints\All包裹Collection，例如：@Constraints\All({ @Constraints\Collection(fields={ /* ... */ }) }) -
@Constraints\Required和@Constraints\Optional在Collection内部用于声明字段是否必须存在；它们与map无关，仅作用于当前层级的键。
? 总结：Collection 约束的核心语义是「按键定义规则的结构化数据校验」，而非「数组校验」。通过 map=false，你就能优雅复用原有约束逻辑，无缝支持单对象与多对象两种接口形态，无需引入新约束或重构验证逻辑。
