跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
MySQL 内置了 MD5()、SHA1() 和 SHA2()。它们可以工作,但返回的是十六进制字符串——一个 SHA-256 哈希是 64 个字符,而底层数据只有 32 字节。以二进制形式存储哈希可以把大小减半,建索引也更高效。VillageSQL 的 vsql_crypto 扩展中的 digest() 返回原始二进制,并且为每种算法提供同一个函数。

MySQL 默认方式:分散的函数,十六进制输出

MySQL 提供了三个独立的哈希函数:
它们可以工作,但存储是浪费的。256 位的 SHA2 返回一个 64 字符的 VARCHAR——是所需字节数的两倍,因为哈希的每个字节被编码为两个十六进制数字。要得到二进制输出,您需要写 UNHEX(SHA2('hello', 256)),这可以工作,但要始终如一地输入很麻烦。 也没有 sha224 或 sha384 选项——您只能使用 MySQL 暴露的那些。

标准变通方法:UNHEX + SHA2

为了紧凑的二进制存储,开发者把 SHA2() 包在 UNHEX() 中:
这为您带来紧凑的存储。它稍微有些冗长,但这是标准做法,对于 SHA-256 和 SHA-512 工作得很好。

使用 VillageSQL:digest()

VillageSQL 的 vsql_crypto 扩展添加了 digest(data, algorithm),它直接返回 VARBINARY 哈希——不需要 UNHEX() 包装。
当您需要可读的字符串用于日志或显示时,使用 HEX():

支持的算法

不要在新应用中使用 MD5 或 SHA-1——两者都有已知的碰撞漏洞。SHA-256 是大多数用途的实用默认选择。 具体到密码存储,digest() 是错误的工具——请参阅 MySQL 中的密码哈希 了解 crypt() 和 gen_salt()。

何时使用每种方法

对于 VillageSQL 上的新项目,digest() 是更简洁的选择。对于现有的纯 MySQL 应用,UNHEX(SHA2()) 同样正确。

常见问题

digest() 和 SHA2() 有什么区别?

SHA2('hello', 256) 返回一个 64 字符的十六进制字符串。digest('hello', 'sha256') 返回一个 32 字节的 VARBINARY。它们计算的是同一个哈希——区别在于编码。二进制存储更紧凑,建索引更快。

我可以用 digest() 检测重复行吗?

可以。将 digest(content, 'sha256') 存储在带索引的列中,然后查询 WHERE sha256 = digest(incoming_content, 'sha256')。这是对上传文件去重、检测变更的记录或构建按内容寻址的查找的常见模式。

digest() 对密码安全吗?

不安全。digest() 是快速哈希——它在微秒级完成计算。密码哈希需要缓慢的、迭代的算法。请使用同一扩展中的 crypt() 和 gen_salt()。请参阅 MySQL 中的密码哈希。

digest() 支持 HMAC 吗?

不支持——digest() 是不带密钥的普通哈希。对于带密钥的认证码,请使用 hmac()。请参阅 MySQL 中的 HMAC 签名。

故障排除

另请参阅