Laravel Blade 中遍历嵌套数组的正确方式

本文详解 Laravel Blade 模板中因错误嵌套 @for 与 @foreach 导致“Trying to access array offset on the value of type int”错误的原因，并提供安全、简洁、符合 Laravel 最佳实践的数组遍历方案。

本文详解 Laravel Blade 模板中因错误嵌套 `@for` 与 `@foreach` 导致“Trying to access array offset on the value of type int”错误的原因，并提供安全、简洁、符合 Laravel 最佳实践的数组遍历方案。

在 Laravel Blade 模板中，直接使用 @for 配合 $listusers[$i] 再嵌套 @foreach 是常见误区——它极易引发类型不匹配错误。你遇到的 ErrorException: Trying to access array offset on the value of type int，根本原因在于：$listusers[$i] 实际返回的是一个整型 ID 值（如 123），而非预期的关联数组（如 ['id' => 123, 'name' => 'John']）。这意味着后续 @foreach($listusers[$i] as $key => $listuser) 试图对一个整数进行遍历，PHP 自然报错。

问题代码的本质逻辑混乱：$listusers 应是一个用户集合（如 Collection 或二维数组），但你却先用 $i 索引取值，再对单个元素做 @foreach ——这相当于把一个用户对象（或其 ID）当作数组来遍历，违背数据结构语义。

✅ 正确做法是避免手动索引，直接使用语义清晰的 @foreach 层级遍历：

<tbody>
    @foreach($listusers as $listuser)
        {{-- 假设 $listuser 是一个用户数组/对象，例如 ['id' => 1, 'name' => 'Alice', 'email' => 'a@example.com'] --}}
        <tr>
            <th scope="row">{{ $listuser['id'] ?? 'N/A' }}</th>
            <td>{{ $listuser['name'] ?? 'Unknown' }}</td>
            <td>{{ $listuser['email'] ?? '-' }}</td>
            <td>{{ $listuser['created_at'] ?? '-' }}</td>
            <td>-</td>
            <td>
                <ul class="list-inline mb-0">
                    <li><a href="#" title="Delete" class="text-danger"><i class="bi bi-trash"></i></a></li>
                    <li><a href="{{ route('admin.users.edit', $listuser['id']) }}" title="Edit" class="text-primary"><i class="bi bi-pencil-square"></i></a></li>
                </ul>
            </td>
        </tr>
    @endforeach
</tbody>

? 关键改进说明：

• 移除冗余 @for 循环：Laravel 的 @foreach 已内置迭代逻辑，无需手动维护 $i 和 $listcount；
• 确保数据结构一致：$listusers 应为 array|Collection，每个 $listuser 是一个用户数组（如从 DB::table()->get()->toArray() 或 User::all()->toArray() 获取）；
• 使用空合并运算符 ??：防御性编程，避免访问不存在的键（如 $listuser['phone'] 为空时崩溃）；
• 路由链接更规范：将静态 # 替换为真实编辑链接（示例中使用 route() 辅助函数，需提前定义命名路由）。

⚠️ 注意事项：

• 若 $listusers 实际是 Eloquent Collection（如 User::all() 返回），可直接用 $listuser->id、$listuser->name 等属性访问（对象语法），无需方括号；
• 切勿在 Blade 中执行数据库查询或复杂逻辑——数据应在 Controller 中预处理完成并传递；
• 使用 @empty($listusers) 可优雅处理空数据场景，提升用户体验。

掌握这种扁平、语义化的遍历方式，不仅能彻底规避类型错误，还能让模板更易读、易维护，真正契合 Laravel “表达意图而非实现细节”的设计哲学。