为何我的应用仅在调试模式下正常？非调试时POST数组为空

问题场景 #

非调试状态下提交表单时，$_POST数组始终为空，但在VS Code中调试时一切正常。单独运行HTML表单（不含PHP代码）时，POST数据可以正常显示。

用户提供的代码 #

表单代码

<form action="/test" method="POST">
<label>Name:</label><input type="text" name="name"><br />
<label>Last name:</label> <input type="text" name="last_name"><br />
<label>Team:</label> <input type="text" name="team"><br />
<label>Contract expire:</label> <input type="text" name="contract_expire"><br />
<input type="submit" name="submit" value="Submit">
</form>

index.php文件

<?php
declare(strict_types=1);
require_once("src/Controller.php");
$config = require_once("config/config.php");
(new Controller($config))->action();
?>

Controller.php文件

<?php

declare(strict_types=1);

require_once("View.php");
require_once("Database.php");

class Controller
{
    private View $view;
    private Database $database;

    public function __construct(array $config){
        $this->view = new View();
        $this->database = new Database($config['db']);
    }

    public function action() {
        if($_POST){
            $params = [
                'name' => $_POST['name'],
                'last_name' => $_POST['last_name'],
                'team' => $_POST['team'],
                'contract_expire' => $_POST['contract_expire']
            ];

            $this->database->createDriver($params);
        }
        $this->view->render();
    }
}
?>

排查与解决步骤 #

• 检查URL重写规则
  表单提交的action="/test"可能对应服务器重写规则（Nginx rewrite、Apache .htaccess等），调试与非调试环境的重写规则可能不一致。比如调试时/test直接指向index.php，非调试时可能被重定向或解析到其他文件，导致POST数据丢失。临时把action改成绝对路径（如action="index.php"）测试，若正常则调整重写规则。

• 对比调试与非调试环境的PHP配置
  查看php.ini中以下关键配置，确保调试与非调试环境一致：

  • post_max_size：设置足够大的值（如8M以上），避免表单数据超出限制导致$_POST为空
  • max_input_vars：确保值大于表单字段数量，防止字段被截断
  • enable_post_data_reading：必须设为On，否则PHP不会读取POST数据
    可在代码开头添加phpinfo();分别查看两个环境的配置差异。

• 排查前置代码对POST数据的消耗
  若Controller.php加载前的代码（如config.php或其他引入文件）提前读取了php://input，会导致$_POST为空（php://input只能读取一次）。调试时断点会停在前置代码前，非调试时直接执行就会消耗POST数据。检查所有引入文件，确保没有提前调用file_get_contents('php://input')。

• 验证请求Content-Type
  表单默认Content-Type为application/x-www-form-urlencoded，若服务器禁用该类型的解析，会导致$_POST为空。在action方法开头添加代码打印请求头：

  var_dump($_SERVER['CONTENT_TYPE']);
  

  确认类型是否符合预期，同时检查服务器是否允许解析该类型请求体。

• 直接打印原始POST数据定位问题
  在Controller.php的action方法最开头添加以下代码，区分是PHP解析问题还是请求传输问题：

  $rawPost = file_get_contents('php://input');
  var_dump($rawPost);
  var_dump($_POST);
  

  若$rawPost有数据但$_POST为空，说明是PHP解析配置问题；若$rawPost也为空，说明请求未传递数据，需排查服务器转发或重定向逻辑。

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