客户列表原本正常，增加省份、会员标签或外部账号字段后，同一客户出现两三行，分页总数也不对。先不要在前端去重；Grid数据源已经被一对多JOIN放大，导出和Mass Action也会跟着错。

确认是哪张表把一行变多行

打开数据库查询日志，复制Grid SQL，把WHERE条件暂时保留并检查重复entity_id：

SELECT main_table.entity_id,COUNT(*) c
FROM customer_grid_flat main_table
LEFT JOIN customer_address_entity a ON a.parent_id=main_table.entity_id
GROUP BY main_table.entity_id HAVING c>1
ORDER BY c DESC LIMIT 20;

一个客户有多个地址是正常数据，因此直接JOIN customer_address_entity一定会重复。扩展标签表、订阅表也可能有同样问题。

按需求选择正确写法

  • 只判断是否存在：用EXISTS子查询，不要JOIN；
  • 只显示默认账单地址：JOIN条件加 a.entity_id=main_table.default_billing；
  • 显示多个标签：先在子查询中GROUP_CONCAT并按customer_id聚合，再JOIN聚合结果；
  • 经常筛选的稳定字段：同步到customer_grid_flat自定义列，避免每次动态关联。

为什么DISTINCT不是万能修复

SELECT DISTINCT只有在所有选出列完全一致时才去重；地址字段不同仍会保留多行，还会让排序和count变慢。GROUP BY entity_id随意取非聚合列也会返回不确定值。

改完后别漏这三项

  1. 筛选新列时设置正确的filterStrategy或addFilterToMap；
  2. count查询与数据查询使用相同的关联语义；
  3. 测试导出和选择全部Mass Action，确保entity_id没有重复。
bin/magento indexer:reindex customer_grid
bin/magento cache:clean config layout

若自定义字段同步到customer_grid_flat，先备份并在预生产执行全量reindex。随机抽查有0、1、多个地址的客户，列表、筛选数量和导出行数应完全一致。