Laravel API返回响应时如何移除message字段中的属性数组

当前报错的核心原因是：校验失败时直接把$validate->errors()返回的MessageBag对象赋值给了message字段，序列化后这个字段是按字段名分组的嵌套对象，和成功响应里message的字符串类型不统一，Angular、Android端按固定类型解析时就会出错，拿不到错误提示。

下面两种改法都能解决问题，按需选择即可：

• 方案1：message直接返回错误文本字符串，适配多端统一解析
  适合只需要弹出错误提示、不需要逐字段展示错误的场景，改完之后所有响应里的message都是字符串类型，不会出现类型不匹配的问题。只需要修改校验失败的返回逻辑，取第一条错误信息即可：

  if ($validate->fails()) {
      return response()->json([
          'code' => 400,
          'message' => $validate->errors()->first()
      ], 400);
  }
  

  改完之后校验失败的响应结构如下，端上可以直接读取message字段展示：

  {
      "code": 400,
      "message": "The country name already exist."
  }
  

  如果需要一次性展示所有错误，可以把所有错误拼接成字符串返回，写法替换为'message' => implode('；', $validate->errors()->all())即可，会把所有错误用分号连接成单个字符串，依然保持类型统一。

• 方案2：拆分字段存储，保留全量结构化错误
  如果端上需要逐字段展示校验错误（比如表单对应字段下方标红提示），不要把结构化错误塞进message字段，单独加errors字段存错误集合，message固定返回通用提示字符串，兼顾类型统一和扩展需求：

  if ($validate->fails()) {
      return response()->json([
          'code' => 400,
          'message' => '参数校验失败',
          'errors' => $validate->errors()
      ], 400);
  }
  

  这种结构下，通用提示读message（字符串，无解析问题），需要逐字段取错误时读errors对象即可，兼容性最好。

调整后的完整接口代码（方案1示例） #

public function createCountry(Request $coun)
{
    $validate = Validator::make($coun->all(), [
        'country_name' => 'required|unique:countries,country_name|regex:/^[a-zA-Z\s]+$/',
    ]);
    if ($validate->fails()) {
        return response()->json([
            'code' => 400,
            'message' => $validate->errors()->first()
        ], 400);
    }
    $country = Country::create([
        'country_name' => $coun->input('country_name'),
    ]);
    return response()->json([
        'code' => 201,
        'message' => 'Country Created Successfully',
        'object' => $country
    ], 201);
}

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