PHP登录表单密码验证调试及登录功能故障排查求助

作为PHP新手遇到登录问题太正常啦，别着急！既然注册功能没问题，那咱们从几个核心点一步步排查，大概率能找到问题所在：

默认PHP可能不会显示具体的错误细节，你只看到“检查数据库用户名时出错”根本不够。在登录页面的最顶部（所有输出之前）加上这段代码，让错误无所遁形：

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

这样能看到具体的数据库报错，比如SQL语法错了？字段名写错了？比模糊的提示有用100倍。

注册正常说明数据库连接没问题，但登录的查询可能踩了坑：

• 确认表名和字段名和注册时完全一致！比如注册时存的是username，别在登录查询里写成user_name；
• 别直接拼接SQL语句（容易注入还容易语法错），用预处理语句更稳妥，举个正确示例：

// 错误写法：单引号包裹变量会导致语法错误
$sql = 'SELECT * FROM users WHERE username='$username'';
// 正确写法：用PDO预处理
$stmt = $pdo->prepare("SELECT * FROM users WHERE username = ?");
$stmt->execute([$输入的用户名]);
$user = $stmt->fetch();

查询后记得先判断用户是否存在：if (!$user) { echo '用户名不存在'; }，而不是直接跳转到“数据库出错”的提示。

比如你的登录表单里用户名输入框的name属性是username，别在PHP里写成$_POST['user']了！可以用var_dump($_POST);把提交的所有数据打印出来，看看有没有拿到正确的用户名和密码。

注册时你肯定用了password_hash()加密密码存进数据库对吧？那登录时必须用password_verify($输入的密码, $数据库里的加密密码)来验证，绝对不能直接对比字符串！很多新手会犯这个错：把输入的明文密码和数据库里的加密字符串直接比，那肯定永远不对。

你已经加了session_start()，但要注意：

• session_start()必须放在所有输出之前，哪怕是一个空格、HTML标签都不行，否则会报错；
• 登录成功后要把用户信息存入Session，比如$_SESSION['user_id'] = $user['id'];，再跳转页面。

<?php
session_start();
// 开启错误提示
ini_set('display_errors', 1);
error_reporting(E_ALL);

// 数据库连接（和注册用同一个就行）
$dsn = 'mysql:host=localhost;dbname=你的数据库名;charset=utf8';
$db_user = '数据库用户名';
$db_pwd = '数据库密码';
try {
    $pdo = new PDO($dsn, $db_user, $db_pwd);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch(PDOException $e) {
    die('数据库连接失败: ' . $e->getMessage());
}

// 处理登录提交
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $input_username = trim($_POST['username']);
    $input_password = trim($_POST['password']);

    // 查询用户是否存在
    $stmt = $pdo->prepare("SELECT * FROM users WHERE username = ?");
    $stmt->execute([$input_username]);
    $user = $stmt->fetch(PDO::FETCH_ASSOC);

    if (!$user) {
        echo '用户名不存在，请检查';
    } else {
        // 验证密码
        if (password_verify($input_password, $user['password'])) {
            // 登录成功，存入Session
            $_SESSION['user_id'] = $user['id'];
            $_SESSION['username'] = $user['username'];
            header('Location: dashboard.php'); // 跳转到登录后的页面
            exit();
        } else {
            echo '密码错误';
        }
    }
}
?>

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

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