Laravel通知表data字段JSON转数组，返回payload数组格式不符合预期

核心问题根源 #

对比目标返回结构和现有代码逻辑，存在3个明确的偏差：

• 循环赋值逻辑错误：现有foreach代码中，每次都会把单条通知的data值直接覆盖给$notifications变量。因为没有做数组元素的追加，哪怕数据库里有多条通知，最终$notifications只会存储循环最后一次遍历到的那条通知的data，根本无法形成“外层列表数组包裹多条通知对象”的结构。你之前dd($notifications)看到的数组，本质是单条通知内部的键值对关联数组，不是通知列表结构，所以接口返回自然和预期不符。
• 数组收集逻辑缺失：没有把每条通知的data作为独立数组元素收集，不符合目标结构中payload为通知列表的要求。
• 响应结构不匹配：依赖自定义的apiSuccess响应方法，没有按照目标格式手动组装外层结构，导致返回的顶层字段和预期的payload/message/result结构对不上。

修复后可直接运行的代码 #

protected function index()
{
    $user = DeviceAuthenticator::getUserByAccessToken();

    // 映射通知集合，提取每条通知的data字段，生成通知列表数组
    $notificationList = $user->notifications->map(function ($notification) {
        return $notification->data;
    })->toArray();

    // 按照目标结构组装响应
    return response()->json([
        'payload' => $notificationList,
        'message' => '',
        'result' => true
    ]);
}

常见排错点 #

• Laravel内置的Illuminate\Notifications\DatabaseNotification模型，已经在$casts属性中把data字段配置为array类型，从数据库读取出值时会自动完成JSON到PHP数组的转换，不需要手动写json_decode($notification->data, true)这类冗余逻辑。
• 如果需要保留团队封装的apiSuccess方法，可以先确认该方法的入参格式：如果它默认会把传入的参数自动放到payload字段下、并且自动补充message和result字段，只需要把整理好的通知列表数组传入即可；如果方法默认结构和要求不匹配，直接用原生response()->json()手动组装结构是最稳妥的方式。
• 如果需要给通知列表排序，可以在映射前追加排序逻辑，比如按创建时间倒序：$user->notifications->sortByDesc('created_at')->map(...)

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