Azure环境下Nginx+PHP8.1提前发200 Header致301设置失败排查

核心原因：脚本执行前已有输出触发响应头发送 #

报错明确提示headers already sent by (output started at /home/site/wwwroot/index.php:1)，说明在执行header()函数前，已有内容被输出到客户端，导致Nginx+PHP-FPM提前发送了200状态的响应头，后续修改头的操作被禁止。以下是最可能的几个原因及排查方向：

1. UTF-8 BOM（字节顺序标记）问题 #

尽管你确认脚本<?php标签前无可见内容，但文件可能带有UTF-8 BOM（字节序列EF BB BF）。PHP 7.4+Apache的组合可能自动忽略了BOM，而PHP 8.1+Nginx环境中，BOM被视为有效输出，直接触发响应头发送。

• 排查：用十六进制编辑器查看文件开头，或执行命令 hexdump -C /home/site/wwwroot/index.php | head -1，若开头显示ef bb bf则存在BOM。
• 解决：将文件编码改为UTF-8 无BOM（可通过VS Code、Notepad++等编辑器设置）。

2. php.ini 输出缓冲配置差异 #

两个环境的output_buffering配置可能不同：

• Apache+PHP 7.4环境可能开启了输出缓冲（output_buffering = On或设置了缓冲大小，如4096），即使有少量输出也会被暂时缓存，直到脚本执行完毕才发送响应头。
• Nginx+PHP 8.1环境可能关闭了输出缓冲（output_buffering = Off），任何微小的输出都会立刻触发响应头发送。
• 排查：在两个环境中创建phpinfo.php（内容<?php phpinfo(); ?>），搜索output_buffering查看配置值。
• 解决：在Nginx环境的php.ini中设置output_buffering = 4096或output_buffering = On，重启PHP-FPM服务。

3. 自动前置文件（auto_prepend_file）输出 #

检查php.ini中的auto_prepend_file配置，若该选项指定了某个文件，且该文件存在空格、换行或BOM等输出，会在你的脚本执行前就发送内容，导致响应头提前生成。

• 排查：查看phpinfo中的auto_prepend_file值，检查对应文件的内容。
• 解决：若无需自动前置文件，将该配置设为空；若必须使用，确保前置文件无任何多余输出（包括<?php前的空白）。

4. PHP 8.1 严格输出检测（次要原因） #

PHP 8.1对输出的检测比7.4更严格，但这不是核心问题——只要存在提前输出，无论哪个版本都会报错，只是环境差异导致表现不同。

快速验证方法 #

在脚本最开头添加输出缓冲开启代码，测试是否能正常返回301：

<?php ob_start(); ini_set("display_errors", 1); header('Status: 301 Moved Permanently', true, 301); ob_end_flush(); ?>

若此方法有效，则可确定是输出缓冲或提前输出的问题，再针对性排查。

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