php报错Cannot send session cookie - headers already sent

封面图 • 2025-11-21 • PHP

这个错误信息：

```
Cannot send session cookie - headers already sent
```

通常发生在 PHP 中尝试使用 `session_start()` 之前，已经有输出内容发送到了浏览器。因为 PHP 的 session 功能依赖于 HTTP 响应头（headers），而一旦有内容（如 HTML、空白字符、PHP 输出等）被发送到浏览器，就会导致 headers 被发送，从而无法再设置 session cookie。

---

### ✅ 常见原因及解决方法：

#### 1. **在 `session_start()` 之前有输出**
- 检查是否有以下情况：
  - 在 `<?php` 标签前有空格、换行或字符。
  - 使用了 `echo`, `print`, `var_dump`, `print_r` 等输出语句。
  - 使用了 `header()` 函数前已经输出了内容。
  - 文件中有 BOM 头（UTF-8 编码的文件可能包含隐藏的 BOM 字符）。

**解决方法：**
- 确保 `session_start()` 是脚本中的第一行，没有任何输出。
- 检查文件是否以 `<?php` 开头，没有前面的空格或字符。
- 使用文本编辑器（如 Notepad++、VSCode）查看文件是否带有 BOM。

---

#### 2. **在 `session_start()` 之后有输出**
- 如果你已经在 `session_start()` 后输出了内容，也可能会报错。
- 例如：
  ```php
  <?php
  session_start();
  echo "Hello";
  ?>
  ```

**解决方法：**
- 把 `echo` 或其他输出语句放在 `session_start()` 之前。
- 或者使用缓冲输出（ob_start()）来延迟输出。

---

#### 3. **文件编码问题（BOM 头）**
- UTF-8 编码的文件如果保存为 **UTF-8 with BOM**，会在文件开头添加一个隐藏的 BOM 字符，这会导致 headers 已经发送。

**解决方法：**
- 将文件保存为 **UTF-8 without BOM** 格式。
- 使用 Notepad++ 打开文件 → 编码 → 转换为 UTF-8 无 BOM。

---

#### 4. **配置中启用了自动输出缓存**
- 如果你使用了 `output_buffering = On`，但仍然出错，可能是某些插件或框架的问题。

---

### ✅ 示例代码

```php
<?php
// 必须是第一行，没有任何输出
session_start();

// 正确的使用方式
$_SESSION['user'] = 'John';
echo "Session started.";
?>
```

---

### ✅ 排查步骤

1. 检查 `session_start()` 是否是脚本的第一行。
2. 查看文件是否以 `<?php` 开头，没有空格或字符。
3. 检查文件是否包含 BOM 头。
4. 检查是否有 `echo` 或 `print` 在 `session_start()` 之前。
5. 使用 `ob_start()` 来缓冲输出：
   ```php
   ob_start();
   session_start();
   // 其他代码
   ob_end_flush();
   ```

---

如果你能提供具体的代码片段，我可以帮你更精确地定位问题。