EasyAdmin4重复使用同实体AssociationField仅显示最后一项如何修复

• 所用框架：EasyAdmin 4
• 实体关联关系：Product 实体与 AttributeValue 实体之间为多对多（M2M）关联

AttributeValue 表存储数据量可达数千条，为降低产品创建、编辑操作的复杂度，需要按属性维度对属性值做拆分筛选，初始筛选逻辑基于 QueryBuilder 实现。

重复声明指向 attributeValues 属性的 AssociationField 字段时，创建/编辑对象的页面仅最后配置的「Property #2」字段可正常渲染，其余绑定同一关联属性的字段均无法显示。

AssociationField::new('attributeValues', 'Property #1')
->setQueryBuilder(function(QueryBuilder $qb) {
    return $qb->andWhere('entity.attribute = 5');
}),

AssociationField::new('attributeValues', 'Property #2')
->setQueryBuilder(function(QueryBuilder $qb){
    return $qb->andWhere('entity.attribute = 1');
}),

问题根因 #

EasyAdmin 4 底层默认以字段构造方法传入的属性名作为唯一渲染标识，同一页面下重复绑定相同属性名的字段时，后加载的字段配置会直接覆盖先前的配置，因此最终仅会渲染最后一个声明的同属性字段。

修复操作 #

• 为每个拆分的属性值筛选字段设置全局唯一的自定义字段名，不可直接复用原关联属性名 attributeValues
• 调用 setPropertyPath('attributeValues') 方法，将自定义命名的字段绑定到实体实际的多对多关联属性上
• 为字段添加 by_reference => false 表单选项，保证多对多关联的数据写入逻辑正常执行
• 每个字段独立配置对应的 QueryBuilder 筛选规则即可

修复后参考代码 #

// 属性ID=5的筛选组，自定义唯一字段名attributeValues_prop5
AssociationField::new('attributeValues_prop5', 'Property #1')
    ->setPropertyPath('attributeValues')
    ->setFormTypeOption('by_reference', false)
    ->setQueryBuilder(function(QueryBuilder $qb) {
        return $qb->andWhere('entity.attribute = 5');
    }),

// 属性ID=1的筛选组，自定义唯一字段名attributeValues_prop1
AssociationField::new('attributeValues_prop1', 'Property #2')
    ->setPropertyPath('attributeValues')
    ->setFormTypeOption('by_reference', false)
    ->setQueryBuilder(function(QueryBuilder $qb){
        return $qb->andWhere('entity.attribute = 1');
    }),

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