PHP PDO::FETCH_GROUP 与 FETCH_UNIQUE 怎么选：结果集分组、覆盖键与空结果验收

商品列表页要按分类展示多件商品时，PDO 的取数模式会直接决定后续 PHP 代码能不能正确遍历。PDO::FETCH_GROUP 会把同一分类的多条记录放到一个分组里；PDO::FETCH_UNIQUE 则把第一列当作键，每个键只保留一条记录。选错模式，页面不一定报错，却可能静默少商品。

先问清楚第一列是否唯一：一对多展示用 PDO::FETCH_GROUP，唯一键索引用 PDO::FETCH_UNIQUE；如果第一列可能重复，不能用 UNIQUE 充当分组。

先看页面真正需要哪一种数组

假设 products 表有 category、product_id、name 三列。分类页需要的是下面这种结构：一个分类下面挂多件商品。

[
    '键盘' => [
        ['product_id' => 101, 'name' => '静音键盘'],
        ['product_id' => 102, 'name' => '矮轴键盘'],
    ],
]

而商品详情缓存更像这样：用唯一的 product_id 快速定位一条记录。

[
    101 => ['name' => '静音键盘', 'category' => '键盘'],
]

这两个需求都能由 fetchAll 返回数组，但键的业务含义完全不同。先确定消费方要遍历“组”还是直接按“唯一键”取值，再选 flag。

用 FETCH_GROUP 保留一个分类下的全部商品

PDO::FETCH_GROUP 按结果集第一列的值建立分组，所以要把 category 放在 SELECT 的第一列。它应当和 PDO::FETCH_ASSOC 一起使用，让每件商品保留字段名。

$sql = query($sql);
$productsByCategory = $stmt->fetchAll(
    PDO::FETCH_GROUP | PDO::FETCH_ASSOC
);

foreach ($productsByCategory as $category => $products) {
    echo $category, "\n";
    foreach ($products as $product) {
        echo $product['product_id'], ': ', $product['name'], "\n";
    }
}

这里的关键链路是 fetchAll → PDO::FETCH_GROUP → category → product_id。只要一个分类有两行结果，内层数组就应有两项；如果只看到一项，先检查 SQL 是否真的返回了多行，而不是急着改遍历代码。

用 FETCH_UNIQUE 建立唯一键索引

当消费方已经知道 product_id 是唯一键，可以把它放在第一列，用 PDO::FETCH_UNIQUE 直接建立索引。这个模式适合批量加载后按 ID 查找，不适合按分类收集多件商品。

$sql = query($sql);
$productsById = $stmt->fetchAll(
    PDO::FETCH_UNIQUE | PDO::FETCH_ASSOC
);

$product = $productsById[101] ?? null;
if ($product === null) {
    throw new RuntimeException('product not found');
}
echo $product['name'];

FETCH_UNIQUE 的前提不是“我希望结果唯一”，而是“第一列在数据中确实唯一”。如果误把 category 放在第一列，同一分类的后续行会覆盖前面的键值；这就是 duplicate key 风险，PHP 可能照常返回数组，丢失却是静默发生的。

不要把两个 flag 当成双保险

手册明确指出，PDO::FETCH_GROUP 和 PDO::FETCH_UNIQUE 同时使用时会作用于同一列，组合没有实际意义。它们不是“先分组、再给每组建唯一索引”的两阶段操作。

如果业务确实需要“分类下按商品 ID 索引”，更稳妥的办法是先使用 FETCH_GROUP 保留全部记录，再在 PHP 中按已知唯一的 product_id 重建内层数组，并对重复 ID 做显式检查。这样数据异常会变成可见错误，而不是被 fetch 模式吞掉。

空结果和重复键要单独验收

空结果时，fetchAll 返回空数组。不要用“数组键不存在”去推断查询失败：数据库连接错误、SQL 错误和查询成功但无匹配是三种不同状态，应由异常模式和业务判断分别处理。

• 分类页：检查 isset($productsByCategory['键盘']) 前，先确认查询成功；不存在时显示空状态。
• 唯一索引：使用 $productsById[$productId] ?? null，把无结果转成明确的未找到分支。
• 数据质量：上线前用重复 product_id 和重复 category 样本跑一次，确认没有误用第一列。

SQL 的列顺序也要纳入代码评审。仅仅把 PHP flag 从 FETCH_GROUP 改成 FETCH_UNIQUE，却忘了调整 SELECT 第一列，往往会让结果结构和变量名对不上。

按结果结构做一个最小决策

• 要得到“一个分类下多条商品”：SELECT category, product_id, name 配合 FETCH_GROUP | FETCH_ASSOC。
• 要得到“一个商品 ID 对应一条商品”：SELECT product_id, name, category 配合 FETCH_UNIQUE | FETCH_ASSOC。
• 第一列不唯一但又想保留全部记录：不要使用 FETCH_UNIQUE，改用分组或普通 FETCH_ASSOC 后显式整理。
• 需要两层索引：先保留完整数据，再用 PHP 做重复键检查，不要把两个 flag 直接按位或。

相关问题

FETCH_UNIQUE 遇到重复键会抛异常吗？

不会把它当成业务异常提示。第一列不唯一时会有记录丢失风险，哪一条被保留不应依赖，因此应在数据模型或应用层提前保证唯一性。

FETCH_GROUP 能用于 fetch() 吗？

这两个特殊模式只对 fetchAll() 的多结果整理有效；单行读取应选择适合单行结构的普通 fetch 模式。

为什么结果里的 category 不见了？

分组列会成为外层数组键，组内记录从剩余列开始。如果需要在每条记录里也保留 category，可以先用普通关联数组读取，再自行组织结构。

把第一列当成数据结构设计的一部分

PDO::FETCH_GROUP 和 PDO::FETCH_UNIQUE 的差异不在名字，而在第一列如何塑造返回数组。分类展示优先保留一对多关系，唯一键读取才适合建立一维索引。把 SQL 列顺序、flag、空结果和重复键一起验收，才能避免页面“能打开但少数据”的隐蔽问题。