Unsupported hash algorithm 错误源于算法名不存在、大小写/拼写错误、hash扩展未启用、disable_functions拦截或FIPS模式禁用，需用hash_algos()确认真实支持列表并严格匹配名称。
Unsupported hash algorithm 错误不是 PHP 环境本身不兼容，而是你调用的算法名在当前 PHP 版本中根本不存在或已被移除 —— 比如用了 sha3-256 却运行在 PHP 7.0 上，或写了 xxh3（PHP 8.1+ 才支持）却部署在 8.0 环境。
查清当前 PHP 支持哪些算法
别猜，直接跑 hash_algos() 看真实列表。不同 PHP 小版本支持差异很大：
- PHP 7.1+ 才有
sha3-224、sha512/256等新 SHA-3 和截断变体 - PHP 7.4+ 才加入
crc32c - PHP 8.1+ 才支持
xxh3、murmur3a等 MurmurHash3 和 xxHash 算法 -
md4、md5、sha1虽然一直存在，但部分严苛环境（如启用了 FIPS 模式）会主动禁用它们
执行 php -r "print_r(hash_algos());" 是最可靠的方式，别依赖文档或旧项目里的写法。
算法名大小写和拼写必须完全匹配
PHP 的 hash() 对算法名区分大小写，且不接受缩写或别名：
立即学习“PHP免费学习笔记（深入）”；
- ❌
"SHA256"、"sha256-256"、"sha2"都会报Unsupported hash algorithm - ✅ 正确写法只有
"sha256"（全小写，无后缀） - ✅
"sha512/224"中的斜杠是必需的，不能写成"sha512_224"或"sha512-224" - ✅
"haval160,4"的逗号和数字必须原样保留，少一个字符就失败
建议从 hash_algos() 输出里直接复制粘贴算法名，避免手误。
扩展未启用或被禁用也会触发该错误
即使算法名正确，hash 扩展没加载，或者被 disable_functions 拦截，也会表现为“不支持”：
- 检查
extension=hash是否在php.ini中启用（默认开启，但某些精简版 phpEnv 可能关掉） - 运行
php -m | grep hash确认模块已加载 - 查看
disable_functions配置是否禁用了hash、hash_hmac或hash_pbkdf2 - 某些安全加固的 phpEnv（如某些 Docker 镜像）会通过
open_basedir或 Suhosin 限制可用算法列表
这类问题不会报“extension not loaded”，而是静默 fallback 到“不支持”，容易误判为版本问题。
升级 PHP 前先验证算法可用性
升级 PHP 版本不是万能解药——新版本可能删算法，也可能加算法，但行为未必向后兼容：
- PHP 8.2 开始，
hash()对无效$options参数更严格，传入不支持的seed会导致警告甚至错误（尤其对murmur3a） - 某些算法（如
tiger128,3）虽在hash_algos()列表里，但在 FIPS 模式下仍不可用，需检查openssl.fips_mode设置 - 生产环境升级前，务必用
hash('xxx', 'test', true)实际调用目标算法，不能只看hash_algos()返回了就认为可用
最容易被忽略的是：算法存在 ≠ 当前运行时上下文允许使用。权限、模式、扩展状态，三者缺一不可。
