Laravel 9x接收x-www-form-urlencoded数据时验证错误无响应求助

使用PHP 8.2搭建Laravel 9.x应用，API接收Form Assembly表单提交的application/x-www-form-urlencoded格式数据时，一旦出现验证错误，应用不会返回错误响应，而是尝试重定向到首页。已知用application/json格式发送数据可正常工作，但Form Assembly不支持该格式，调试困难。

相关代码：

ApplicationsController #

class ApplicationsController extends Controller
{
    use HasApplicationEmail, EmailsTrait;

    public function store(CreateApplicationRequest $request)
    {
       ...
    }
}

CreateApplicationRequest #

class CreateApplicationRequest extends FormRequest
{
    public function rules()
    {
        return [
            'email'                     => ['required', 'email'],
            'event_slug'                => ['required'],
            'application_fee'           => ['required', 'numeric'],
            'applicant_birthdate'       => ['required'],
            'applicant_gender'          => ['required'],
            'marital_status'            => ['required'],
            'applicant_street_1'        => ['required'],
            'applicant_city'            => ['required'],
            'applicant_state_province'  => ['required'],
            'applicant_zip'             => ['required'],
            'applicant_country'         => ['required'],
            'applicant_phone'           => ['required'],
            'transaction_number'        => ['required'],
        ];
    }

    public function authorize()
    {
        return true;
    }
}

方案1：在自定义FormRequest中重写验证失败逻辑 #

直接在CreateApplicationRequest里重写failedValidation方法，强制返回JSON格式的错误响应：

use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exceptions\HttpResponseException;

class CreateApplicationRequest extends FormRequest
{
    // 保留原有rules和authorize方法

    protected function failedValidation(Validator $validator)
    {
        throw new HttpResponseException(response()->json([
            'errors' => $validator->errors()
        ], 422));
    }
}

方案2：全局配置验证错误处理 #

如果多个API请求都需要处理这种情况，在App\Providers\AppServiceProvider的boot方法中添加全局逻辑，针对application/x-www-form-urlencoded请求返回JSON错误：

use Illuminate\Validation\ValidationException;

public function boot()
{
    $this->app['events']->listen('validation.failed', function ($validator) {
        $request = request();
        if ($request->isMethod('post') && $request->header('Content-Type') === 'application/x-www-form-urlencoded') {
            throw ValidationException::withMessages($validator->errors()->toArray())
                ->status(422)
                ->response(fn() => response()->json(['errors' => $validator->errors()], 422));
        }
    });
}

方案3：将路由移至API路由组 #

确保API路由放在routes/api.php中，Laravel默认会给该路由组添加api中间件，该中间件组会让框架优先返回JSON响应，避免web路由默认的重定向行为。

方案4：自定义中间件强制JSON响应 #

创建中间件，将application/x-www-form-urlencoded格式的请求强制标记为需要JSON响应：

// app/Http/Middleware/ForceJsonResponse.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class ForceJsonResponse
{
    public function handle(Request $request, Closure $next)
    {
        if ($request->header('Content-Type') === 'application/x-www-form-urlencoded') {
            $request->headers->set('Accept', 'application/json');
        }

        return $next($request);
    }
}

然后在app/Http/Kernel.php的api中间件组中添加该中间件，或者直接绑定到目标路由上：

// 路由绑定示例
Route::post('/applications', [ApplicationsController::class, 'store'])->middleware(ForceJsonResponse::class);

• 在CreateApplicationRequest的rules方法中临时添加日志，确认请求数据是否正确接收：

  use Illuminate\Support\Facades\Log;
  
  public function rules()
  {
      Log::info('Received request data:', $this->all());
      // 原有规则
  }
  

• 使用Postman或curl模拟application/x-www-form-urlencoded请求，测试验证错误时的响应是否符合预期。

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