params = {k: v for k, v in params.items() if v not in (None, '') and k != 'sign'}
raw = '&'.join(f'{k}={params[k]}' for k in sorted(params))
sign = hmac.new(key.encode(), raw.encode(), hashlib.sha256).hexdigest()
对接方按文档实现签名，自己验签一直不通过，改了几次拼接口径还是不匹配。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。
追下去是这么回事：双方对参数排序、空值处理和 URL 编码规则理解不同，拼出的待签串不一致。
「接口签名校验」改完先别急着全量，挑一台机器放半天，真有问题这段时间就能看出来。权限不要一口气开到最大，先加到够用再往上试，范围小才好收。
把复现步骤压到三条以内，交给同事也能跑出来，才算真的定位清楚。改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。
验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。能分两步做的操作就别合成一步，中间看一眼返回值，出问题好判断。
处理上按这个顺序：固定按参数名升序拼接；排除空值与签名字段；统一使用同一编码和密钥。
确认没问题再收工，双方用同一组参数算出的签名一致，接口返回成功。