PHP 7.4 中 hex2bin() 行为未变但错误报告更严格，要求输入必须为偶数长度且仅含合法十六进制字符，否则触发 E_WARNING 并返回 false；需校验输入来源并显式处理 false 返回值。
hex2bin() 在 PHP 7.0 到 7.4 升级中行为没变，但错误报告更严格——它不再容忍奇数长度或非法字符，而是直接触发 E_WARNING 并返回 false。问题通常不是函数坏了，而是旧代码里混着脏数据却一直没暴露。
为什么升级后突然报“Hexadecimal input string must have an even length”
PHP 7.0 其实也会报这个警告，但很多老项目把 error_reporting 设为 E_ALL & ~E_WARNING，或者 display_errors = Off + log_errors = Off，导致警告被静默吞掉。PHP 7.4 默认配置更保守，加上部分主机环境启用 error_reporting = E_ALL，于是原来“悄悄失败”的地方现在明晃晃报错。
- 检查你传给
hex2bin()的变量是否来自用户输入、URL 参数、数据库字段或缓存——这些地方最容易混入空格、换行、前缀0x或截断的十六进制串 - 用
var_dump($input)看原始值，别只信strlen($input)；trim()和preg_replace('/[^0-9a-fA-F]/', '', $input)往往比硬加@更可靠 - PHP 7.4 不会自动补零或忽略末尾乱码，必须是纯偶数长度的合法十六进制字符串
hex2bin() 和 base_convert() 别再混用
这是最常被翻车的误解：hex2bin() 解码的是「十六进制编码的二进制字节流」，比如 "616263" → "abc"；而 base_convert("abc", 16, 2) 是无效的——base_convert() 只处理数字字符串（如 "ff" → "255"），不能处理任意十六进制字节序列。
- 如果你原本想把十进制数转二进制，用
base_convert((string)$num, 10, 2) - 如果你拿到的是类似
"0xdeadbeef"这种带前缀的十六进制数，先ltrim($hex, '0x')再传给hex2bin()——但注意：这仅当它是字节序列时才合理；如果是数值，应走base_convert()或hexdec()+decbin() - 调用
hex2bin()前务必校验：ctype_xdigit($input) && strlen($input) % 2 === 0
升级后 hex2bin() 返回 false 但没报错？检查错误抑制符和错误级别
有些代码写成 @hex2bin($str)，在 PHP 7.4 中仍能压制警告，但返回值是 false。如果后续没判断返回值就直接 strlen() 或 json_encode()，就会触发新错误（比如 PHP 8+ 对 strlen(false) 抛 TypeError）。
立即学习“PHP免费学习笔记（深入）”；
- 去掉所有
@，改用显式判断：$bin = hex2bin($str); if ($bin === false) { /* 处理解码失败 */ } - 确认当前环境的
error_reporting值：在脚本开头加var_dump(error_reporting());，避免依赖 php.ini 的全局设置 - PHP 7.4 开始，
hex2bin()的返回类型声明为string|false，静态分析工具（如 PHPStan）会据此报错，提醒你处理false分支
真正棘手的不是 hex2bin() 本身，而是它像一面镜子——照出旧系统里那些常年未校验的输入边界。升级后第一件事，不是改函数调用，而是顺藤摸瓜，查清那个十六进制字符串从哪来、中间有没有被截断、有没有被 URL 解码污染过、是否可能为空或 null。
