jQuery AJAX请求PHP返回500错误排查求助

阿华AIGC实验室

2026-5-19

jQuery AJAX请求返回PHP 500内部服务器错误，无法定位服务器端原因

Hey everyone,

我最近开发用户注册功能时碰到了个棘手的问题：前端用jQuery发AJAX请求到PHP后端处理注册逻辑，结果一直返回500 Internal Server Error。我知道这是服务器端的问题，但翻遍代码也找不到具体报错点，希望社区的各位能帮我排查一下！

我的文件结构

前端注册页面：register.php
AJAX逻辑脚本：assets/js/register.js
AJAX请求处理文件：ajax/handle-register.php
用户业务逻辑类：classes/User.php
数据库配置文件：config/config.php

各部分代码详情

1. JavaScript AJAX代码（register.js）

$(document).on('submit', '#register-form', function(e) {
    e.preventDefault();
    
    const formData = $(this).serialize();
    
    $.ajax({
        url: 'ajax/handle-register.php',
        type: 'POST',
        data: formData,
        dataType: 'json',
        success: function(response) {
            if (response.success) {
                alert('注册成功！');
                window.location.href = 'login.php';
            } else {
                alert('注册失败：' + response.message);
            }
        },
        error: function(xhr, status, error) {
            console.log('请求错误：', xhr.status, error);
            alert('服务器出错，请稍后重试');
        }
    });
});

2. PHP AJAX处理文件（handle-register.php）

<?php
require_once '../config/config.php';
require_once '../classes/User.php';

header('Content-Type: application/json');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    echo json_encode(['success' => false, 'message' => '无效的请求方式']);
    exit;
}

$user = new User();
$username = $_POST['username'] ?? '';
$email = $_POST['email'] ?? '';
$password = $_POST['password'] ?? '';

try {
    $result = $user->register($username, $email, $password);
    echo json_encode(['success' => true, 'message' => '注册成功']);
} catch (Exception $e) {
    echo json_encode(['success' => false, 'message' => $e->getMessage()]);
}
?>

3. User类文件（classes/User.php）

<?php
class User {
    private $db;

    public function __construct() {
        global $pdo;
        $this->db = $pdo;
    }

    public function register($username, $email, $password) {
        // 验证输入
        if (empty($username) || empty($email) || empty($password)) {
            throw new Exception('请填写所有必填字段');
        }

        // 检查用户名是否已存在
        $stmt = $this->db->prepare("SELECT id FROM users WHERE username = ?");
        $stmt->execute([$username]);
        if ($stmt->rowCount() > 0) {
            throw new Exception('用户名已存在');
        }

        // 检查邮箱是否已存在
        $stmt = $this->db->prepare("SELECT id FROM users WHERE email = ?");
        $stmt->execute([$email]);
        if ($stmt->rowCount() > 0) {
            throw new Exception('邮箱已被注册');
        }

        // 哈希密码
        $hashedPassword = password_hash($password, PASSWORD_DEFAULT);

        // 插入用户数据
        $stmt = $this->db->prepare("INSERT INTO users (username, email, password) VALUES (?, ?, ?)");
        return $stmt->execute([$username, $email, $hashedPassword]);
    }
}
?>

4. 配置文件（config/config.php）

<?php
$host = 'localhost';
$dbname = 'my_database';
$username = 'root';
$password = 'my_password';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die('数据库连接失败：' . $e->getMessage());
}
?>

5. 注册视图代码（register.php）

<!DOCTYPE html>
<html>
<head>
    <title>用户注册</title>
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script src="assets/js/register.js"></script>
</head>
<body>
    <form id="register-form">
        <div>
            <label>用户名：</label>
            <input type="text" name="username" required>
        </div>
        <div>
            <label>邮箱：</label>
            <input type="email" name="email" required>
        </div>
        <div>
            <label>密码：</label>
            <input type="password" name="password" required>
        </div>
        <button type="submit">注册</button>
    </form>
</body>
</html>

我已经尝试过的排查步骤

检查服务器PHP错误日志，但没有找到该请求的相关报错记录
确认所有PHP文件权限为755，配置文件权限为644
直接访问ajax/handle-register.php并手动传参，仍返回500错误
验证数据库连接信息，确认可以正常连接
在handle-register.php开头添加error_reporting(E_ALL); ini_set('display_errors', 1);，但未显示任何错误信息

实在找不到问题出在哪了，有没有大佬能帮我分析一下可能的原因？感谢大家的帮助！

内容的提问来源于stack exchange，提问作者Lewis Blundell