改用PDO替代mysqli后$_SESSION失效的技术问题求助

这种从mysqli切换到PDO后会话变量丢失的情况我碰到过好几次，大概率是PDO的默认特性或者代码里的小疏漏导致的，咱们一步步来排查：

1. 先给PDO开错误报告，揪出潜在问题 #

PDO默认是静默失败的——就算你的SQL查询有语法错误、字段名写错，它也不会主动报错，只会默默返回空结果。这就会导致你以为脚本运行正常，但其实根本没查到用户数据，自然写不进$_SESSION['user']。

你可以在初始化PDO连接的时候加上错误模式配置：

$dsn = 'mysql:host=你的主机;dbname=你的数据库;charset=utf8mb4';
$pdo = new PDO($dsn, '用户名', '密码', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 抛出异常显示错误
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // 默认返回关联数组，和mysqli结果格式一致
]);

开启后，如果查询有问题，PHP会直接抛出异常，你就能立刻看到哪里出错了。

2. 确认PDO查询真的拿到了用户数据 #

虽然你说参数正确时能返回用户信息，但还是建议在会话赋值前加个调试输出，确认$user变量不是空的：

// 示例PDO登录查询
$stmt = $pdo->prepare("SELECT id, username, email FROM users WHERE username = ?");
$stmt->execute([$_POST['username']]);
$user = $stmt->fetch();

// 验证密码（注意：数据库中必须存哈希后的密码）
if ($user && password_verify($_POST['password'], $user['password'])) {
    // 加这行调试，看看拿到的用户数据是什么
    var_dump($user);
    $_SESSION['user'] = $user;
} else {
    echo "登录失败";
}

如果var_dump出来是空的，那说明查询逻辑有问题——比如字段名和mysqli版本不一致，或者密码验证逻辑错了。

3. 检查session_start()的位置 #

不管用mysqli还是PDO，session_start()必须在所有输出之前调用，哪怕是个空格、换行或者HTML标签都不行。如果PDO版本的脚本里，你把session_start()放到了PDO连接之后，而中间不小心输出了内容（比如连接数据库时的调试信息），就会导致会话无法正常初始化，$_SESSION自然就用不了。

一定要确保session_start()是脚本的第一行有效代码：

<?php
session_start(); // 这行必须最靠前，在任何输出之前
// 然后才是PDO连接、查询逻辑

4. 排查会话ID是否被意外重置 #

极少数情况下，PDO的某些驱动配置可能会影响会话，但这种情况很少见。你可以在PDO连接前后打印会话ID，看看是不是变了：

session_start();
echo "连接PDO前的会话ID: " . session_id() . "<br>";

// 初始化PDO连接
$pdo = new PDO(...);

echo "连接PDO后的会话ID: " . session_id() . "<br>";

如果两个ID不一样，说明会话被重置了，这时候要检查php.ini里的会话配置，比如session.save_path是不是有写入权限，或者有没有其他代码修改了会话设置。

5. 确认密码验证逻辑和mysqli版本一致 #

如果你在mysqli版本里用了password_verify()来验证哈希密码，那PDO版本里也必须用同样的逻辑——不能直接把明文密码和数据库里的哈希值对比，否则肯定查不到用户，自然写不进会话。

按照上面的步骤排查，基本就能找到问题所在了。

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