MySQL BIT_COUNT 怎么统计位标志中被置为 1 的数量

如果一列保存的是权限、能力或状态位掩码，MySQL 直接用 BIT_COUNT(flags) 就能统计其中被置为 1 的位数。比如整数 13 的二进制是 1101，结果就是 3。需要特别注意的是：输入为 NULL 时结果也是 NULL；表达式进入二进制字符串上下文后，统计的是字节里的置位，而不是把字符先当成一个十进制数字。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/bit-functions.html

实际查询中，先确认位掩码按数字保存还是按二进制字符串保存，再使用 BIT_COUNT。整数位标志直接统计；可能为 NULL 的列要保留或显式转换为业务默认值。

问题现场：权限列里到底打开了多少项能力

假设权限表中的 flags 用一个整数保存：最低位代表读取，第二位代表写入，第三位代表删除，第四位代表导出。某个用户的值是 13，也就是 1101，开启了读取、删除和导出三项能力。

这时目标不是判断某一位是否开启，而是给列表增加“已开启能力数”。最直接的列计算如下：

-- 用整数位掩码统计每个用户已经打开的能力数量
SELECT
    user_id,
    flags,
    BIT_COUNT(flags) AS enabled_count
FROM account_acl
WHERE flags IS NOT NULL;

BIT_COUNT 返回的是一个无符号 64 位整数。它统计值为 1 的位，而不是统计十进制数字里有几个字符，也不是统计字符串长度。对整数位掩码来说，这正好对应“开启了多少个独立标志”。

先确认输入上下文：数字和二进制字符串不是一回事

排查结果不符合预期时，最容易忽略的是输入类型。MySQL 8.4 的位函数既支持数字，也支持 BINARY、VARBINARY 和 BLOB 这类二进制字符串。普通非二进制字符串会转换成 BIGINT，而二进制字符串会按字节内容处理。

官方手册给出的对比很有代表性：

-- 数字 64 只有一个置位；二进制字符串 "64" 的两个字节合计有七个置位
SELECT BIT_COUNT(64) AS numeric_count,
       BIT_COUNT(BINARY 64) AS binary_count;

-- 普通字符串会按数字语义转换；_binary 会保留二进制字符串语义
SELECT BIT_COUNT('64') AS text_count,
       BIT_COUNT(_binary '64') AS binary_text_count;

第一组结果分别是 1 和 7。原因不是函数随机变化，而是两列表达式的输入语义不同：数字 64 的二进制只有一个 1；字符串 "64" 的字节分别是字符 6 和 4，按字节统计时会得到七个置位。

因此，权限和状态字段最好在表设计和查询中保持一种明确语义。不要把“数字掩码”和“编码后的二进制字节”混成同一个字段，再靠结果倒推类型。

落到表查询：保留原掩码并给出可读计数

在列表或报表里，建议同时返回原始 flags 和计数列。这样业务排查时可以从计数回看原始值，不会只看到一个无法解释的数字。

-- 保留原始掩码，便于把计数和权限值放在同一行核对
SELECT
    user_id,
    flags,
    BIT_COUNT(flags) AS enabled_count,
    CASE
        WHEN flags IS NULL THEN '未设置'
        WHEN flags = 0 THEN '没有开启能力'
        ELSE '至少开启一项能力'
    END AS flag_state
FROM account_acl
ORDER BY user_id;

如果业务要求“没有设置”也按零项处理，可以只在展示层或查询层显式指定默认值：

-- 只有在业务明确把 NULL 当作零项时才这样转换
SELECT
    user_id,
    COALESCE(BIT_COUNT(flags), 0) AS enabled_count
FROM account_acl;

这里的 COALESCE 是业务语义转换，不是 BIT_COUNT 自动把 NULL 当成零。审计、权限回收或数据修复场景通常应该保留 NULL，避免把“没有值”和“明确关闭全部能力”混为一谈。

定位异常：NULL、字符数字和 BIT 列的边界

遇到“同样看起来是 64，结果却不同”时，可以按下面的顺序判断：

1. 先看是否为 NULL。 BIT_COUNT(NULL) 返回 NULL，不是 0。
2. 再看表达式类型。 普通字符串会按数字转换；BINARY、VARBINARY 或 BLOB 会进入二进制字符串语义。
3. 最后看是否做了显式转换。 如果字段实际是二进制类型，但业务约定是整数掩码，应在数据写入和读取边界统一转换，不要只在某一条 SQL 中猜测。

对需要强制按数字解释的值，可以把转换写在查询里，并给转换后的结果起一个明确别名：

-- 明确把可转换的字段按无符号整数解释，再统计置位数量
SELECT
    user_id,
    CAST(flags_text AS UNSIGNED) AS flags_number,
    BIT_COUNT(CAST(flags_text AS UNSIGNED)) AS enabled_count
FROM account_acl_text
WHERE flags_text IS NOT NULL;

但显式转换也会掩盖脏数据。生产查询如果需要长期使用，最好先把列的存储约定固定下来，并在写入处拒绝不符合约定的值。

复查清单：把“统计 1 的数量”说清楚

一句话总结：当字段代表一个整数位掩码时，BIT_COUNT 是统计已开启标志数量的合适函数；当字段可能是二进制字符串或 NULL 时，先把输入语义写清楚，再解释结果。

相关问题

BIT_COUNT(0) 会返回什么？

返回 0，因为数值零没有被置为 1 的位。

为什么 BIT_COUNT(NULL) 不是 0？

因为 NULL 表示未知或缺失值。只有业务确认缺失值等同于“没有开启能力”时，才使用 COALESCE(BIT_COUNT(flags), 0)。

应该用 BIT_COUNT 统计字符串长度吗？

不应该。字符串长度使用字符或字节长度函数；BIT_COUNT 的语义是统计输入位表示中被置为 1 的位。