GET请求PHP邮箱校验接口返回HTML异常问题排查

故障根因 #

用户名校验分支运行正常，说明会话初始化、数据库连接、前端AJAX基础逻辑无异常，故障仅存在于邮箱格式校验的专属代码路径，按触发概率从高到低排序：

• 邮箱校验分支触发PHP致命错误，环境默认输出HTML格式错误页
  该分支直接拼接未转义的邮箱字符串生成SQL时，特殊字符极易引发SQL语法错误；另外分支内变量名拼写错误、mysqli函数传参顺序错误、对布尔值类型的查询失败结果调用mysqli_num_rows()等问题，都会触发PHP致命错误。若PHP配置开启HTML格式的错误渲染，错误页内容会在echo $result前输出，最终前端拿到整页HTML。
• 跳转逻辑未终止执行+请求未携带会话Cookie
  若邮箱校验请求因参数异常未携带站点会话Cookie，$_SESSION中无email字段时会执行跳转至login.php的header指令，而$.get默认跟随302重定向，会返回login.php整页源码。现有跳转代码未加exit终止，后续逻辑仍会执行，属于明确的代码隐患。
• 分支内意外输出HTML内容
  邮箱校验分支中若存在include/require带HTML结构的文件，会在结果输出前打印额外HTML内容，导致响应格式不符合预期。

修复方案 #

1. 先定位响应来源
   打开浏览器开发者工具-网络面板，找到邮箱校验的请求查看响应内容：
   • 若响应为login.php源码：检查Cookie路径、跨域配置，所有header跳转逻辑后必须加exit终止执行：

     if(!isset($_SESSION['email'])){
         header("Location:login.php");
         exit;
     }
     

   • 若响应包含PHP Fatal error/Warning报错信息：直接根据报错行号修正代码，邮箱查询逻辑替换为预处理语句，从根源避免SQL语法错误和注入风险：

     if(filter_var($link, FILTER_VALIDATE_EMAIL)){
         $stmt = mysqli_prepare($conn, "SELECT id FROM users WHERE email = ?");
         mysqli_stmt_bind_param($stmt, "s", $link);
         mysqli_stmt_execute($stmt);
         mysqli_stmt_store_result($stmt);
         $count = mysqli_stmt_num_rows($stmt);
         $result = $count > 0 ? 'Taken' : 'Not Taken';
         mysqli_stmt_close($stmt);
     }
     

2. 强制接口返回纯文本格式
   在process.php输出结果前，清空缓冲区并设置纯文本响应头，屏蔽所有意外输出：

   ob_clean();
   header("Content-Type: text/plain");
   echo $result;
   exit;
   

3. 前端增加容错处理
   AJAX回调中先对返回值做去空白处理，增加请求失败日志方便排查：

   $.get('../process.php', {link: link}, function(data) {
       data = data.trim();
       if(data === 'Taken') {
           $('#email-dc').css('border', '1px solid tomato');
           $('#email-not-taken, #green-check').hide();
           $('#email-taken').show();
           email_state = false;
       } else if(data === 'Not Taken') {
           $('#email-dc').css('border', '1px solid #008000');
           $('#email-not-taken, #green-check').show();
           $('#email-taken').hide();
           email_state = true;
       }
   }).fail(function(xhr) {
       console.log('校验请求异常：', xhr.responseText);
   });
   

快速定位技巧 #

临时注释邮箱校验分支所有逻辑，直接写入$result = 'Not Taken';后输出，若前端能正常拿到字符串，即可确认故障点在原邮箱分支代码内，逐行放开注释即可快速定位错误行。

内容的提问来源于stack exchange，提问作者Zach D.