验签失败主因是算法细节未对齐：需确认RSA-SHA256或HMAC-SHA256、严格按序拼接参数、剔除空值、小写字段名、秒级时间戳，RSA验签前必须base64_decode，公钥格式须匹配PEM或PKCS#8。
PHP 接收第三方签署平台回调时，验签失败的常见原因
绝大多数“回调接收不到”或“验签失败”的问题，不是 PHP 写错了，而是签名算法细节没对齐。第三方平台（如 e 签宝、法大大、契约锁）返回的 sign 通常是用 RSA-SHA256 或 HMAC-SHA256 算的，但 PHP 默认不会自动处理 Base64 编码后的签名解码、参数排序规则、空值/NULL 字段剔除逻辑。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认平台文档里写的签名算法是
rsaSha256还是hmacSha256，别只看“SHA256”就默认用hash_hmac('sha256', ...) - 所有参与签名的字段必须严格按平台要求的顺序拼接，不能用
ksort()后直接http_build_query()—— 某些平台要求忽略空值、字段名全小写、时间戳用秒级而非毫秒 - RSA 验签前，务必用
base64_decode($sign)解码，否则openssl_verify()一定返回false - 验签用的公钥要确认格式：是 PEM（以
-----BEGIN PUBLIC KEY-----开头）还是 PKCS#8；若平台给的是 DER，得先转 PEM：openssl x509 -inform der -in public.der -pubkey -noout > public.pem
PHP 处理回调时如何安全地更新合同状态
回调不是“通知”，而是“事实确认”。平台回调成功只代表他们完成了签署动作，不代表你的数据库已同步。如果直接在回调里执行 UPDATE contracts SET status = 'signed' WHERE id = ?，遇到重试、并发或网络抖动就会出错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 回调入口必须做幂等控制：用平台传来的唯一
flowId或fileId作为数据库唯一索引，插入前先INSERT IGNORE或用ON DUPLICATE KEY UPDATE - 不要在回调中直接调用 PDF 渲染、邮件发送等耗时操作；改成写入消息队列（如 Redis List 或 Beanstalkd），由后台 Worker 异步处理
- 回调响应必须在 3 秒内返回 HTTP 200，且 body 为空或仅含
{"code":0}；任何file_get_contents('php://input')后的 JSON 解析失败，都要捕获并记录原始 raw body，方便排查 - 记录完整日志：包括原始请求头（特别是
X-Request-ID）、$_POST、$_GET、file_get_contents('php://input')和验签结果，别只记“验签失败”
PHP 调用第三方签署接口生成签署链接时，timestamp 和 nonce 怎么设
这两个参数不是“随便填个时间戳+随机数”就行。平台会校验 timestamp 是否在允许窗口内（通常是 ±5 分钟），nonce 是否重复（用于防重放）。PHP 本地时间不准、microtime(true) 误用、uniqid() 无熵，都会导致接口返回 "invalid_timestamp" 或 "duplicate_nonce"。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
timestamp必须用time()（秒级），不是date('U')或strtotime('now')；避免用new DateTime()->getTimestamp()，因为时区设置可能影响结果 -
nonce别用uniqid('', true)—— 它依赖微秒和进程 ID，在高并发下有碰撞风险；改用bin2hex(random_bytes(16))（PHP 7.0+）或md5(uniqid(mt_rand(), true) . time()) - 签名前，把所有待签名参数（含
timestamp、nonce、appId等）按 key 字典序升序排列，再拼成key1=value1&key2=value2格式；注意 URL 编码是否已由平台要求跳过 - 某些平台要求
timestamp是服务器当前时间，但你用的是 NTP 不同步的虚拟机？那就得定期跑ntpdate -s time.windows.com，或者直接调用平台提供的时间接口校准
PHP 生成带签章的 PDF 合同，为什么用 tcpdf 或 dompdf 总是盖歪/模糊
电子签章不是“往 PDF 上贴图”。真正合规的签章必须嵌入数字签名（PAdES），并满足《电子签名法》对“不可篡改、可验证”的要求。用 tcpdf->Image() 直接贴 PNG 章，只是视觉模拟，不具备法律效力，且 PDF 渲染引擎对 DPI、坐标系、缩放比例处理不一致，导致位置偏移。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 放弃在 PHP 里“自己画章”。正确路径是：调用签署平台的
/v1/files/{fileId}/seal接口，传入合同 PDF 的 base64，由平台返回已盖好合规签章的新 PDF 下载地址 - 如果必须本地合成（例如测试环境离线预览），用
setasign/fpdi+setasign/tcpdf组合：先用 FPDI 导入原 PDF，再用 TCPDF 的addSignatureField()添加签名域，最后调用output()触发 PAdES 签名（需配合私钥） - 切勿用
imagick把 PDF 转成图片再加章——分辨率丢失、文字变锯齿、无法选中文本，且彻底破坏 PDF 结构 - 所有签章图片必须是透明背景 PNG，尺寸建议 200×80px 起，DPI 设为 300；但最终生效与否，取决于是否嵌入了符合 ETSI EN 319 142 标准的 LTV（Long Term Validation）签名
