本文介绍如何在单条 sql 查询中直接计算各分类（cat）的分钟数占总分钟数的百分比，避免 php 后处理，提升性能与可维护性，并给出正确实现、常见陷阱及优化建议。
本文介绍如何在单条 sql 查询中直接计算各分类（cat）的分钟数占总分钟数的百分比，避免 php 后处理，提升性能与可维护性，并给出正确实现、常见陷阱及优化建议。
在 MySQL 中为分组结果动态计算百分比（如各分类分钟数占总分钟数的比例），最高效的方式是在 SQL 层完成聚合与比例计算，而非先取数据再用 PHP 循环计算——这不仅减少网络传输和应用层逻辑复杂度，还能利用数据库的优化器进行一次性聚合。
核心思路是：将“全量总分钟数”作为标量子查询或派生表（derived table），与分组结果做关联或交叉连接（CROSS JOIN），从而在每行中访问全局汇总值。但需特别注意：原始答案中使用的 CROSS JOIN 方式存在严重逻辑缺陷——其子查询 t 未做聚合，却使用 DISTINCT nid, cat, ...，导致笛卡尔积膨胀和结果失真（如返回 16 行却声称“Total minutes was 5344”，说明子查询未正确求和）。
✅ 正确做法是：用标量子查询（scalar subquery）计算全局总分钟数，简洁、安全、语义清晰：
SELECT
COUNT(DISTINCT cn.nid) AS tagged,
cn.cat,
SEC_TO_TIME(AVG(TIME_TO_SEC(cn.duration))) AS duration,
ROUND(SUM(TIME_TO_SEC(cn.duration)) / 60, 0) AS minutes,
CONCAT(
ROUND(
(SUM(TIME_TO_SEC(cn.duration)) / 60) * 100.0 /
(SELECT COALESCE(ROUND(SUM(TIME_TO_SEC(cn2.duration)) / 60, 0), 0)
FROM client_note cn2
JOIN client_note_tag_items cni2 ON cni2.note_id = cn2.nid
LEFT JOIN client_note_tags cnt2 ON cnt2.tag_id = cni2.tag_id
WHERE cn2.dte >= ?
AND cn2.dte <= ?
AND cn2.name NOT LIKE 'Resolution%'
AND cn2.duration IS NOT NULL),
2
),
'%'
) AS percent
FROM client_note cn
JOIN client_note_tag_items cni ON cni.note_id = cn.nid
LEFT JOIN client_note_tags cnt ON cnt.tag_id = cni.tag_id
WHERE cn.dte >= ?
AND cn.dte <= ?
AND cn.name NOT LIKE 'Resolution%'
AND cn.duration IS NOT NULL
GROUP BY cn.cat
ORDER BY cn.cat ASC;? 关键要点说明：
- 标量子查询更可靠：SELECT ... FROM (...) 子查询若返回多行会报错，强制保证全局总值唯一；而 CROSS JOIN 易因逻辑错误引入重复或空行。
- COALESCE(..., 0) 防零除：当无匹配记录时，总分钟数为 NULL，COALESCE 确保分母不为空，避免 NULL 传播。
- CONCAT(..., '%') 格式化输出：比 FORMAT() 更可控（FORMAT() 会添加千位分隔符，如 1,80%），且明确保留两位小数。
- 参数占位符复用注意：SQL 中 ? 占位符需按执行顺序传入对应参数（共 4 个：起始日期×2，结束日期×2）。实际使用 PDO 时，应确保 $stmt->execute([$start, $end, $start, $end])。
⚠️ 注意事项：
- 时间字段 duration 必须为 TIME 类型（如 '00:06:22'），否则 TIME_TO_SEC() 将返回 0；
- WHERE 条件（尤其是 duration IS NOT NULL 和 name NOT LIKE）必须在主查询和子查询中严格一致，否则百分比基准失真；
- 若数据量极大，可考虑将总分钟数预先查出并缓存于 PHP 变量中，再通过 UNION ALL 或应用层计算，避免重复全表扫描。
总结：优先在 SQL 层完成百分比计算，采用标量子查询获取全局总和，配合 ROUND 与 CONCAT 实现专业、健壮、易读的结果输出——这是兼顾性能、准确性和可维护性的最佳实践。
