将PHP登录脚本改为使用PDO预处理语句后无结果问题排查

首先得说，安全课程里搞PHP代码确实有点头疼，尤其是基础不太熟的时候，空白页这种问题真的磨人——不过别慌，咱们一步步来排查：

1. 先打开错误提示，找到隐藏的问题 #

空白页90%的概率是代码有报错，但PHP默认把错误藏起来了。你可以在PHP文件最开头加上这几行，强制显示所有错误：

error_reporting(E_ALL);
ini_set('display_errors', 1);

这样刷新页面就能看到具体哪里出问题了，比如SQL语法错了、参数绑定不对之类的，比瞎猜管用多了。

2. 检查你的PDO预处理语句写法 #

先确认你的SQL语句占位符和bindValue对应对不对：

• 如果用命名占位符（比如:username），那bindValue的第一个参数要和占位符完全一致，比如：

  $sql = "SELECT * FROM users WHERE username = :username AND password = :password";
  $stmt = $pdo->prepare($sql);
  // 这里的:username要和SQL里的一模一样
  $stmt->bindValue(':username', $_POST['username'], PDO::PARAM_STR);
  $stmt->bindValue(':password', $_POST['password'], PDO::PARAM_STR);
  

• 如果用问号占位符，那bindValue的第一个参数是位置（从1开始），比如：

  $sql = "SELECT * FROM users WHERE username = ? AND password = ?";
  $stmt = $pdo->prepare($sql);
  $stmt->bindValue(1, $_POST['username'], PDO::PARAM_STR);
  $stmt->bindValue(2, $_POST['password'], PDO::PARAM_STR);
  

另外，别忘了密码如果是哈希存储的（安全课程应该会要求这个），你不能直接把POST的密码和数据库里的哈希值对比，得用password_verify()函数，这个很容易错！

3. 检查语句执行和结果处理 #

执行预处理语句后，一定要判断是否执行成功，并且正确获取结果：

// 执行语句后先判断返回值
if ($stmt->execute()) {
    // 检查有没有匹配的用户
    $user = $stmt->fetch(PDO::FETCH_ASSOC);
    if ($user) {
        // 这里要做登录成功的操作，比如启动会话、跳转页面或者输出内容
        session_start();
        $_SESSION['user_id'] = $user['id'];
        echo "登录成功！";
        // 或者跳转：header("Location: dashboard.php"); exit;
    } else {
        echo "用户名或密码错误";
    }
} else {
    // 输出执行失败的错误信息
    print_r($stmt->errorInfo());
}

如果执行后没有任何输出，很可能是你没写登录成功/失败的反馈代码，或者跳转的时候没加exit（比如header跳转后，后面的代码可能还在跑，但页面会空白）。

4. 确认数据库连接的细节 #

虽然你说连接正常，但还是要确认连接时有没有设置错误模式，比如：

$pdo = new PDO("mysql:host=localhost;dbname=your_db;charset=utf8mb4", "user", "pass");
// 开启PDO的错误模式，这样出错时会抛出异常，更容易排查
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

加上这个，连接或者SQL出错时会直接抛出错误，不会默默失败。

给你一个完整的极简示例，你可以对照自己的代码找差异：

<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);

session_start();

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

// 处理登录请求
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = $_POST['username'] ?? '';
    $password = $_POST['password'] ?? '';

    // 预处理SQL
    $sql = "SELECT id, username, password FROM users WHERE username = :username";
    $stmt = $pdo->prepare($sql);
    $stmt->bindValue(':username', $username, PDO::PARAM_STR);
    $stmt->execute();

    $user = $stmt->fetch(PDO::FETCH_ASSOC);

    if ($user && password_verify($password, $user['password'])) {
        $_SESSION['user_id'] = $user['id'];
        echo "登录成功！欢迎回来，" . $user['username'];
        // 或者跳转：header("Location: dashboard.php"); exit;
    } else {
        echo "用户名或密码错误，请重试";
    }
}
?>

<!-- 登录表单 -->
<form method="POST">
    <input type="text" name="username" placeholder="用户名" required>
    <input type="password" name="password" placeholder="密码" required>
    <button type="submit">登录</button>
</form>

按照上面的步骤排查，应该能找到问题所在——毕竟安全课程里的案例一般不会太复杂，大概率是某个细节没注意到，比如占位符写错、没处理结果、或者没输出反馈内容。

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