You need to enable JavaScript to run this app. PHP联系表单服务端密钥哈希校验异常:本该返回true却实际返回false
优惠活动
大模型
产品
解决方案
定价
更多

PHP联系表单服务端密钥哈希校验异常:本该返回true却实际返回false

表单Token校验失败的核心原因与修复方案

核心问题根因

你现在的校验逻辑失效,本质是token的生成时机、存储位置、对比逻辑完全错位,你之前测试时“移除token函数的首尾判断、函数直接返回true”后,表单流程完全正常的现象,也侧面印证了问题:SESSION本身读写没有故障,只是因为token生成时机错位,导致SESSION里存储的token值和前端传过来的token值从根本上就不相等。具体拆成4个可直接定位的bug:

  • token生成逻辑放错位置,前端根本拿不到正确值
    你把generateFormToken('form1')的调用写在了if(isset($_POST['submit_client']))的POST判断分支内部。这意味着只有用户已经点击提交、请求到达服务端的时候,才会新生成token写入SESSION;而用户第一次打开表单页面时,根本不会进入这个POST判断分支,此时$newToken变量为空,前端两个隐藏域输出的token值都是空字符串,SESSION里也没有存储对应token。
  • 提交时直接覆盖了SESSION里的token,导致对比必然失败
    用户提交POST请求进入分支后,第一行就执行了$newToken = generateFormToken('form1'),直接把SESSION里本该和前端token匹配的旧值覆盖成了全新的随机hash。哪怕之前SESSION里存了正确的token,这一步执行完也已经和前端带过来的旧token不匹配了。
  • SESSION启动位置不合理,存在存储失效风险
    你把session_start()放在了读取POST参数、初始化reCaptcha实例的代码后面,部分服务器环境下如果前面的代码有哪怕一个字符的提前输出,就会导致SESSION无法正常写入、读取,SESSION值根本存不住。
  • 前端存在重复的同名字段
    你在表单里写了两个name="token"的隐藏域,虽然当前场景下两个值相同不会直接导致错误,但同名字段在提交时存在被浏览器截断、被恶意构造请求覆盖的风险,属于冗余问题。

具体修复步骤

  • 把session_start()挪到整个PHP代码的最开头,确保在任何输出、业务逻辑执行前运行,避免SESSION失效。
  • 把token生成逻辑从POST提交分支中移出来,放到页面渲染阶段执行:不管是不是POST请求,只要页面加载,就提前生成token并存入SESSION,同时把这个值赋值给$newToken传给前端模板渲染,保证用户打开页面时,表单隐藏域能拿到正确的token值,SESSION里也存了对应匹配值。
  • 收到POST提交请求时,先执行token校验,校验通过后再依次执行reCaptcha验证、字段格式校验、发邮件逻辑,校验通过前绝对不能重新生成token覆盖SESSION值。
  • 删掉前端重复的token隐藏域,只保留一个即可。
  • 补充一次性token消费逻辑:token校验通过后,立刻销毁SESSION里的旧token,再生成新的token存入SESSION,实现单次有效,避免token被截获后重复使用。
  • 不要在非POST请求阶段直接读取$_POST的参数值,不然会产生大量PHP notice报错,把字段读取的逻辑挪到POST判断分支内部更规范。

修复后核心逻辑参考(关键代码片段)

// 代码最开头先启动SESSION
session_start();
require_once './php/recaptcha/src/autoload.php';
$siteKey = 'xxxxx';
$secret = 'xxxxxxxxx';
$recipient = "sales@xxxx.com";
$subject = "Contact Form - QUOTE APPLICATION - EN";

// 提前定义生成、校验函数
function generateFormToken($form) {
  $_SESSION[$form.'_token'] = md5(uniqid(microtime(), true));
  return $_SESSION[$form.'_token'] ;
}
function verifyFormToken($form) {
  if (!isset($_SESSION[$form.'_token'])) { return false;}
  if (!isset($_POST['token'])) {return false;}
  if ($_SESSION[$form.'_token'] !== $_POST['token']) {return false;}
  return true;
}
// 页面渲染阶段就提前生成token,供前端表单展示用
$newToken = generateFormToken('form1');

// 处理POST提交逻辑
if(isset($_POST['submit_client'])) {
    // 先校验token,再走后续流程
    if (!verifyFormToken('form1')) {
        die("非法请求");
    }
    // 后续reCaptcha验证、字段校验逻辑
    $recaptcha = new \ReCaptcha\ReCaptcha($secret);
    $gRecaptchaResponse = $_POST['g-recaptcha-response'];
    $remoteIp = $_SERVER['REMOTE_ADDR'];
    $resp = $recaptcha->verify($gRecaptchaResponse, $remoteIp);

    $name = $_POST['name'];
    $email = $_POST['email'];
    $telephone = $_POST['telephone'];
    $company = $_POST['company'];
    $message = $_POST['message'];
    $formcontent=" From: $name \n Phone: $telephone \n Company: $company \n Message: $message";
    $mailheader = "From: $email \r\n";

    if ($resp->isSuccess() && /* 保留原有字段格式校验规则 */) {
        mail($recipient, $subject, $formcontent, $mailheader) or die("Error!");
        // 校验通过后销毁旧token,生成新的token供下次使用
        unset($_SESSION['form1_token']);
        $newToken = generateFormToken('form1');
        echo '<script language="javascript">alert("Thank you, we\'ll be in touch shortly!");</script>';
    } else {
        die("Error!");
    }
}

临时排查小技巧

在校验函数中临时增加变量输出,比如在函数开头加var_dump($_SESSION[$form.'_token'] ?? '不存在', $_POST['token'] ?? '不存在');die;,就能直接看到SESSION和POST里的token值是否匹配,快速定位是哪个环节出了问题。
另外注意原代码里的JS alert存在单引号转义问题,哪怕校验通过,JS语法错误也会导致提示框不弹出。


内容的提问来源于stack exchange,提问作者avia

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 12:06:03