Symfony 7中POST请求下getContent()与request->get结果不同的原因

问题场景 #

后端代码如下：

#[Route("test")]
public function testing(Request $request) {
    $_POST = json_decode($request->getContent(), true);
    if(isset($_POST["line"])) { // 第一种方法
        // JS请求时生效
    }
    if($request->request->get("line") != null) { // 第二种方法
        // Symfony请求时生效
    }
    return $this->json([]);
}

两种判断永远不会同时成立：

• 第一种方法（手动赋值$_POST）在JS请求时生效：

await fetch("/test", {
    method: "POST",
    body: JSON.stringify({
        "line": "the line"
    }),
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
});

• 第二种方法（request->request->get）在PHPUnit测试时生效：

$client->request('POST', "/test", [
    "line" => "the line"
], [], [ 'CONTENT_TYPE' => 'application/json', 'ACCEPT' => 'application/json' ]);

原因分析 #

1. Symfony Request对象的解析逻辑 #

Symfony的$request->request属性专门用于解析**application/x-www-form-urlencoded或multipart/form-data**类型的POST数据（即表单提交格式）。当请求的Content-Type为application/json时，Symfony不会自动将JSON内容解析到$request->request中，而是保留原始内容在$request->getContent()里。

你的JS请求是标准JSON POST：Content-Type设为application/json，body是JSON字符串。此时原生PHP的$_POST为空（PHP默认只解析表单格式的POST数据），你手动通过json_decode($request->getContent(), true)赋值$_POST，所以第一个判断生效，但$request->request仍然是空的，第二个判断不生效。

2. PHPUnit测试的请求构造错误 #

你在PHPUnit测试中使用的$client->request()方法，第三个参数$parameters是用于传递表单参数的。即使你设置了CONTENT_TYPE为application/json，Symfony测试客户端仍然会把这个参数编码成application/x-www-form-urlencoded格式的body发送，而非JSON。此时：

• Symfony自动解析表单数据到$request->request，所以第二个判断生效；
• $request->getContent()拿到的是表单格式字符串（比如line=the+line），json_decode后得到null，手动赋值的$_POST为空，第一个判断不生效。

修正方案 #

1. 统一请求处理逻辑 #

不要手动赋值$_POST，遵循Symfony规范处理JSON请求：

#[Route("test")]
public function testing(Request $request) {
    // 处理JSON请求，toArray()等价于json_decode($request->getContent(), true)，且自动判断Content-Type
    $data = $request->toArray();
    if(isset($data["line"])) {
        // 所有合法JSON请求都会进入这里
    }
    
    // 若需兼容表单请求，可保留request->request的判断
    if($request->request->get("line") !== null) {
        // 处理表单格式的POST请求
    }
    
    return $this->json([]);
}

2. 修正PHPUnit测试代码 #

要发送真正的JSON请求，需将JSON字符串作为$client->request()的第六个参数（$content）传递，而非第三个参数：

$client->request(
    'POST',
    "/test",
    [], // 表单参数留空
    [], // 文件参数留空
    [ 'CONTENT_TYPE' => 'application/json', 'ACCEPT' => 'application/json' ],
    json_encode(["line" => "the line"]) // 传入JSON格式的请求体
);

修改后，无论JS请求还是PHPUnit测试，都会进入同一个判断分支，逻辑保持一致。

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