Laravel Validator移除数组空字段：产品测试时thumbnail字段丢失

看起来你在编写产品创建的测试用例时，遇到了一个很容易踩坑的问题：明明发送的数据里包含了thumbnail: null，但到控制器验证环节这个字段却消失了。结合你给出的代码和数据，我来梳理下最可能的原因和对应的解决方案：

1. 最常见的元凶：array_filter默认过滤null值 #

很多时候我们会在请求类的prepareForValidation()方法里对数组数据做清理，比如用array_filter()来移除空值，但**array_filter()默认会把null、false、0、空字符串这类“假值”全部过滤掉**。

如果你在自定义请求类（比如StoreProductRequest）里写了类似这样的代码：

protected function prepareForValidation()
{
    $this->merge([
        'formats' => collect($this->formats)->map(function ($format) {
            return array_filter($format); // 这里会把thumbnail: null直接删掉！
        })->toArray(),
    ]);
}

那这就是问题所在。解决办法是给array_filter()传一个回调函数，明确只移除你不需要的空值（比如空字符串），保留null：

protected function prepareForValidation()
{
    $this->merge([
        'formats' => collect($this->formats)->map(function ($format) {
            return array_filter($format, function ($value) {
                return $value !== ''; // 只过滤空字符串，null会被保留
            });
        })->toArray(),
    ]);
}

2. 验证规则未允许null值 #

如果你的验证规则里没有给formats.*.thumbnail加上nullable规则，Laravel的验证器可能会自动排除这个字段（尤其是当你用$request->validated()获取验证后的数据时）。

检查你的请求类规则：

// 错误示例：没有允许null值
public function rules()
{
    return [
        'formats' => 'required|array',
        'formats.*.upc' => 'required|string',
        'formats.*.vcode' => 'required|string',
        'formats.*.thumbnail' => 'string', // 这里没加nullable，null值会被视为无效并排除
    ];
}

修改成允许null的规则：

public function rules()
{
    return [
        'formats' => 'required|array',
        'formats.*.upc' => 'required|string',
        'formats.*.vcode' => 'required|string',
        'formats.*.thumbnail' => 'nullable|string', // 加上nullable，允许字段为null
    ];
}

3. 全局中间件或第三方包过滤了null值 #

有些项目会在全局中间件里统一处理请求数据，比如用array_filter($request->all())来清理空值，这也会导致null字段被移除。

检查你的app/Http/Kernel.php里的全局中间件列表，看看有没有类似的处理逻辑。如果有的话，同样需要调整array_filter的回调，避免过滤null值。

4. 先确认数据是否真的发送出去了 #

最后，可以在测试用例里加个调试步骤，确认$product变量里的thumbnail确实存在：

// 测试用例里先打印数据，确认结构正确
dd($product['formats'][0]['thumbnail']); // 应该输出null
$response = $this->post(route('products.store'), $product);

也可以在控制器里先打印请求的原始数据，看看是不是真的没收到：

public function store(Request $request)
{
    dd($request->input('formats.0.thumbnail')); // 检查是否能获取到null
    // 后续验证逻辑
}

按照这几个步骤排查，应该能快速找到问题所在！

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