课程调查网站Session值重置问题：本地正常生产服务器异常

看起来你遇到了本地开发正常，但部署到生产服务器后Session无法持久化的典型问题，我来帮你一步步排查和解决：

1. 先确认Session初始化的正确性 #

首先要保证所有用到Session的页面最顶部都调用了session_start()，而且调用前绝对不能有任何输出（包括空格、HTML注释、空行）。生产服务器的PHP配置通常对输出更严格，哪怕一个不起眼的前置空格都会导致Session Cookie无法正确写入，直接引发Session重置。

错误示例（有前置输出）：

<!-- 这个注释会提前输出内容，破坏Session初始化 -->
<?php session_start(); ?>

正确示例：

<?php
session_start();
// 后续业务代码写在这里
?>

另外，检查代码里有没有意外重置Session的逻辑，比如误写了session_destroy()，或者在某些分支里重新初始化了存储已播放音频的数组：

// 这类代码会直接清空Session，要确认只在需要的场景使用
session_destroy();
// 或者意外覆盖了已有的数组
$_SESSION['completed_audios'] = [];

2. 排查生产服务器的Session配置 #

登录生产服务器，通过phpinfo()输出查看PHP的Session相关配置，重点关注这几个参数：

• session.save_path：确认这个路径存在，且PHP进程有读写权限。如果路径不存在或权限不足，Session文件根本存不下来，每次请求都会生成新的Session。
• session.gc_maxlifetime：这个是Session文件的过期时间，如果设置得太短（比如几分钟），而你的调查需要用户花时间完成，Session会被系统的垃圾回收机制自动清理。
• session.cookie_lifetime：如果设置为0，Session Cookie会在浏览器关闭后失效，但正常情况下只要浏览器保持打开就应该持续有效；如果生产环境设了极短的时间，也会导致Session频繁重置。

3. 验证Session ID的一致性 #

在页面顶部加一段测试代码，打印当前的Session ID，看每次请求是否一致：

<?php
session_start();
echo "当前Session ID：" . session_id();
?>

如果刷新页面后Session ID每次都变，说明Session完全没被保存，这时候要回到步骤2，重点检查session.save_path的权限和存在性。

4. 可选：改用数据库存储Session（更稳定） #

如果生产服务器的文件系统Session存储有问题，可以换成数据库存储（比如MySQL），这种方式更稳定，也方便排查问题。

先创建一个Session存储表：

CREATE TABLE sessions (
    id VARCHAR(255) PRIMARY KEY,
    data TEXT NOT NULL,
    created_at INT(11) NOT NULL
);

然后在PHP里设置自定义的Session处理器：

<?php
// 数据库连接信息
$db_host = 'localhost';
$db_user = '你的数据库用户名';
$db_pass = '你的数据库密码';
$db_name = '你的数据库名';

// 自定义Session处理函数
function session_open($save_path, $session_name) {
    global $db_conn;
    $db_conn = mysqli_connect($db_host, $db_user, $db_pass, $db_name);
    return $db_conn ? true : false;
}

function session_close() {
    global $db_conn;
    mysqli_close($db_conn);
    return true;
}

function session_read($session_id) {
    global $db_conn;
    $result = mysqli_query($db_conn, "SELECT data FROM sessions WHERE id = '$session_id'");
    $row = mysqli_fetch_assoc($result);
    return $row ? $row['data'] : '';
}

function session_write($session_id, $data) {
    global $db_conn;
    $created_at = time();
    mysqli_query($db_conn, "REPLACE INTO sessions (id, data, created_at) VALUES ('$session_id', '$data', $created_at)");
    return true;
}

function session_destroy($session_id) {
    global $db_conn;
    mysqli_query($db_conn, "DELETE FROM sessions WHERE id = '$session_id'");
    return true;
}

function session_gc($max_lifetime) {
    global $db_conn;
    $expire_time = time() - $max_lifetime;
    mysqli_query($db_conn, "DELETE FROM sessions WHERE created_at < $expire_time");
    return true;
}

// 注册自定义Session处理器
session_set_save_handler('session_open', 'session_close', 'session_read', 'session_write', 'session_destroy', 'session_gc');
session_start();
?>

5. 临时调试：记录Session变化 #

可以在关键逻辑处添加日志，跟踪Session的修改和读取情况，方便定位问题：

<?php
session_start();
// 记录初始Session状态到错误日志
error_log("Session初始状态: " . print_r($_SESSION, true));

// 初始化已播放音频数组
if (!isset($_SESSION['completed_audios'])) {
    $_SESSION['completed_audios'] = [];
}

// 处理用户选择音频的逻辑（示例）
if (isset($_POST['selected_audio'])) {
    $audio_id = $_POST['selected_audio'];
    if (!in_array($audio_id, $_SESSION['completed_audios'])) {
        $_SESSION['completed_audios'][] = $audio_id;
    }
}

// 记录处理后的Session状态
error_log("Session处理后状态: " . print_r($_SESSION, true));
?>

之后查看生产服务器的PHP错误日志，就能清楚看到Session是否被正确修改，以及后续请求能否读取到更新后的值。

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