POST请求Payload为null时如何修改Laravel请求避免报错？

问题原因 #

Symfony的Request类解析JSON请求体时，若原始内容为null会直接返回null，但Laravel后续逻辑期望解析结果是数组类型的ParameterBag，因此触发报错。$request->replace([])仅修改了请求的参数集合，并未改动原始JSON内容和已解析的json属性，所以无法解决问题。

可行解决方案 #

方案1：中间件修改原始请求内容与解析属性 #

在自定义中间件中直接修改请求的原始内容，并重置已解析的参数：

public function handle(Request $request, Closure $next)
{
    if ($request->isJson() && trim($request->getContent()) === 'null') {
        // 将原始请求内容设为空JSON对象
        $request->setContent('{}');
        
        // 重置解析后的请求参数集合
        $request->request = new \Symfony\Component\HttpFoundation\ParameterBag();
        // 移除已缓存的解析结果
        $request->attributes->remove('json');
    }

    return $next($request);
}

方案2：全局重写JSON解析逻辑 #

创建自定义Request类，覆盖默认的JSON解析逻辑，确保null被转为空数组：

namespace App\Http;

use Illuminate\Http\Request as BaseRequest;
use Symfony\Component\HttpFoundation\ParameterBag;

class Request extends BaseRequest
{
    protected function getJsonPayload()
    {
        $payload = parent::getJsonPayload();
        
        // 若解析结果为null，返回空ParameterBag
        return $payload ?? new ParameterBag();
    }
}

然后在public/index.php中替换默认的请求捕获逻辑：

// 替换原Illuminate\Http\Request
$request = App\Http\Request::capture();

方案3：中间件捕获解析异常并修复 #

通过捕获JSON解析异常，直接将无效的null payload替换为空JSON：

public function handle(Request $request, Closure $next)
{
    if ($request->isJson()) {
        try {
            $json = $request->json();
            if ($json === null) {
                $request->json()->replace([]);
            }
        } catch (\Throwable $e) {
            // 处理解析失败的情况，设置空请求内容
            $request->setContent('{}');
            $request->request = new \Symfony\Component\HttpFoundation\ParameterBag();
        }
    }

    return $next($request);
}

内容的提问来源于stack exchange，提问作者D'Arcy Rail-Ip