PHP session_start报错无output started位置提示如何解决

为什么报错不显示output started at位置 #

看不到输出位置提示是两个原因共同导致的：

• PHP 8.0版本中如果php.ini里output_buffering被设置为On（无大小限制的全量缓冲），PHP不会记录输出触发的具体文件、行号，headers发送相关的报错就不会附带输出起始位置信息。
• WordPress核心在入口文件加载阶段就会启动自身的输出缓冲层，你在init钩子调用session_start()时，最早的输出已经被WordPress注册的缓冲层捕获，PHP默认的错误回溯无法穿透多层自定义缓冲定位起始点。

第一步：修改PHP配置开启完整错误提示 #

找到你当前PHP 8.0 FPM对应的php.ini文件，调整以下配置项：

; 不要设置为On，必须指定具体字节数值，PHP才会记录输出位置
output_buffering = 4096
error_reporting = E_ALL
display_errors = On

修改完成后重启PHP-FPM服务生效：

systemctl restart php8.0-fpm

第二步：临时穿透缓冲层定位输出点 #

在你的测试插件开头添加如下调试代码，清空所有已存在的输出缓冲层，强制PHP暴露最早的输出位置：

<?php
/*
Plugin Name: Session启动调试插件
*/
// 调试专用：清空所有层级的输出缓冲
while (ob_get_level() > 0) {
    ob_end_clean();
}

add_action('init', function() {
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
    session_start();
});

刷新页面触发报错后，就能看到完整的(output started at 具体文件路径:行号)提示。

你当前测试场景的根因修复 #

你用原生Twenty Twenty-Two主题、无其他插件仍触发报错，核心原因是init钩子的执行时机过晚：WordPress在执行到init钩子前，已经完成HTTP头发送、部分页面内容输出，本身就不适合调用session_start()。
WordPress环境下正确的session启动方式如下，要放到最早的执行钩子中，同时判断session状态避免重复启动：

add_action('plugins_loaded', function() {
    if (session_status() === PHP_SESSION_NONE) {
        session_start();
    }
}, 1);

内容的提问来源于stack exchange，提问作者László Monda