如何解决Lumen中通过API网关上传文件返回422错误的问题

问题根因 #

你的API网关在转发请求时，默认仅处理普通表单/JSON参数，没有正确携带enctype='multipart/form-data'类型的文件二进制数据和对应请求头，导致微服务端无法识别到上传的文件字段，触发必填项校验报错。

解决方案 #

按以下步骤修改网关层代码即可：

1. 修改网关store方法，保留上传文件实例 #

不要直接用$request->all()传递参数，需要手动把文件实例加入传递数据：

public function store(Request $request)
{
    $data = $request->all();
    // 存入上传的文件实例
    if ($request->hasFile('note_background_name')) {
        $data['note_background_name'] = $request->file('note_background_name');
    }
    return $this->successResponse($this->backgroundService->createBackground($data, Response::HTTP_CREATED));
}

2. 修改performRequest方法，适配文件上传场景 #

如果检测到请求包含文件，就构建multipart格式的请求体转发，这里以Guzzle HTTP客户端为例：

public function createBackground($data)
{
    return $this->performRequest('POST', '/backgrounds', $data);
}

protected function performRequest($method, $endpoint, $data = [])
{
    $client = new \GuzzleHttp\Client();
    $requestOptions = [];
    // 判断是否包含上传文件实例
    $hasUploadFile = collect($data)->some(fn ($item) => $item instanceof \Illuminate\Http\UploadedFile);

    if ($hasUploadFile) {
        $multipartContent = [];
        foreach ($data as $key => $value) {
            if ($value instanceof \Illuminate\Http\UploadedFile) {
                // 组装文件参数
                $multipartContent[] = [
                    'name' => $key,
                    'contents' => fopen($value->getPathname(), 'r'),
                    'filename' => $value->getClientOriginalName(),
                    'headers' => [
                        'Content-Type' => $value->getMimeType()
                    ]
                ];
            } else {
                // 组装普通文本参数
                $multipartContent[] = [
                    'name' => $key,
                    'contents' => $value
                ];
            }
        }
        $requestOptions['multipart'] = $multipartContent;
    } else {
        // 普通请求走原有逻辑
        $requestOptions['form_params'] = $data;
    }

    $response = $client->request($method, '你的微服务接口前缀地址' . $endpoint, $requestOptions);
    return json_decode($response->getBody(), true);
}

3. Postman请求校验 #

请求网关时不要手动设置Content-Type: multipart/form-data请求头，让Postman自动生成带boundary参数的请求头，Body选择form-data格式，note_background_name字段类型切换为File，再选择本地图片发送即可。

注意：如果微服务端有跨域/请求头过滤逻辑，要确保multipart/form-data类型的请求头没有被拦截。

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