ThinkPHP 中 session_start() 报“Headers already sent”错误，是因为框架已自动启动session，手动调用会因已有输出（BOM、空格、echo等）导致HTTP头重复发送；应使用session()或Session::类方法操作，禁用调试输出并确保output_buffering开启。
为什么 session_start() 在 ThinkPHP 中报错 “Headers already sent”
ThinkPHP 默认在框架启动时自动管理 session，手动调用 session_start() 极大概率触发 “Headers already sent” 错误。根本原因是输出缓冲未清理、或已有输出（空格、BOM、echo、日志打印）提前发送了 HTTP 头。
常见错误现象：Warning: session_start(): Cannot send session cache limiter - headers already sent；或者页面空白但 PHP 日志里有该警告。
- ThinkPHP 5.1+ 使用
think\Session类统一管理，底层已调用session_start()，无需、也不应手动再调 - 检查入口文件
public/index.php或配置文件是否有意外输出（比如 UTF-8 BOM、末尾换行、var_dump()遗留） - 第三方类库或行为钩子中执行了
echo、print、error_log()等输出操作，也会破坏 header 发送时机
如何安全地清理输出缓冲避免 session 冲突
ob_clean() 不是万能解药，它只清当前级缓冲，且不能撤回已发送的 HTTP 头。在 ThinkPHP 中滥用反而掩盖真实问题。
真正有效的做法是：让输出缓冲由框架统一控制，而不是手动干预。
立即学习“PHP免费学习笔记（深入）”；
- 确认
output_buffering在 php.ini 中设为On或数值（如4096），而非Off - 禁用所有非必要调试输出：关闭
debug模式（'app_debug' => false），或确保think\Log不在响应前写入内容 - 若必须手动控制缓冲（如导出 CSV），应在
Response发送前完成，且不与 session 初始化逻辑交叉——例如不要在initialize()方法里调ob_start()
ThinkPHP 中正确读写 session 的方式
直接调用原生 $_SESSION 或 session_start() 会绕过框架的 session 驱动和生命周期管理，导致 Redis/数据库 session 失效、跨请求丢失等问题。
应始终使用 ThinkPHP 封装的接口：
- 写入：
session('user_id', 123)或Session::set('token', 'abc') - 读取：
session('user_id')或Session::get('token') - 销毁：
session(null)或Session::clear() - 注意：配置项
session.type决定实际存储位置（file、redis、memcache），修改后需同步检查驱动是否可用
检查头信息是否已被发送的实用技巧
ThinkPHP 自身不会提前发送头，但扩展、中间件、异常处理过程可能触发。最可靠的方式是在关键节点插入诊断代码。
- 在控制器方法开头加：
if (headers_sent($file, $line)) { throw new Exception("Headers sent in {$file} on line {$line}"); } - 查看
runtime/log/下最新日志，搜索session_start和headers already sent关联上下文 - 用
php --ini确认加载的是预期 php.ini；部分环境（如 Docker）可能被覆盖，导致session.save_path不可写却无提示
真正麻烦的从来不是怎么清缓冲，而是哪一行代码偷偷 echo 了不可见字符——尤其当文件从 Windows 编辑器保存、带 BOM 的 UTF-8 文件混入 vendor 目录时，连 grep 都难定位。
