本文讲解如何在 Laravel Blade 模板中正确解码并格式化存储为 JSON 字符串的嵌套对象字段（如 non_sql），避免类型错误，实现清晰、可读的键值对输出。
本文讲解如何在 laravel blade 模板中正确解码并格式化存储为 json 字符串的嵌套对象字段（如 `non_sql`），避免类型错误，实现清晰、可读的键值对输出。
在 Laravel 开发中，有时出于灵活性考虑，会将结构化数据以 JSON 字符串形式存入数据库字段（如 non_sql）。但直接在 Blade 中使用 json_decode() 会返回 PHP 对象（stdClass），而 Blade 的 {{ }} 语法要求输出必须是字符串——这正是你遇到 htmlspecialchars(): Argument #1 ($string) must be of type string, stdClass given 错误的根本原因。
✅ 正确做法是：先解码 JSON 字符串为关联数组（或对象），再遍历其内部 data 层，并按需格式化输出。仅用 implode(',', json_decode(...)) 虽能绕过报错，但会丢失键名（如输出 "4,5,4,5"），不符合你期望的 data_1: 4 格式。
推荐在 Blade 中使用如下清晰、健壮、可读性强的写法：
<td>
@if(!empty($item['non_sql']))
@php
$parsed = json_decode($item['non_sql'], true);
$data = $parsed['data'] ?? [];
@endphp
@foreach($data as $key => $value)
{{ $key }}: {{ $value }}<br>
@endforeach
@else
NA
@endif
</td>
? 关键说明：
-
json_decode($item['non_sql'], true)的第二个参数true强制返回关联数组（而非stdClass），便于 Blade 安全遍历； - 使用
?? []和?? 'NA'防止null或缺失键导致的报错； -
- 整个逻辑包裹在
@if中，兼顾空值与异常场景。
? 进阶建议（更优雅）：
若该逻辑在多处复用，建议将解析逻辑移至模型访问器（Accessor）中，例如在对应 Eloquent 模型中添加：
// In your model (e.g., Record.php)
protected $casts = [
'non_sql' => 'array', // ✅ 自动解码（需确保数据库字段为 TEXT/JSON 类型且内容合法）
];
// Or define an accessor
public function getNonSqlDataAttribute()
{
$raw = $this->attributes['non_sql'] ?? '';
$decoded = json_decode($raw, true);
return $decoded['data'] ?? [];
}
然后 Blade 中可直接简洁调用：
<td>
@forelse($item->non_sql_data as $key => $value)
{{ $key }}: {{ $value }}<br>
@empty
NA
@endforelse
</td>
✅ 这样既提升了模板可读性，又实现了逻辑复用与数据层解耦。
⚠️ 注意事项：
- 始终验证 JSON 字符串合法性（
json_last_error() === JSON_ERROR_NONE），生产环境建议在控制器或模型层预处理； - 避免在 Blade 中执行复杂逻辑或数据库查询，保持视图轻量；
- 若
non_sql字段实际存储的是 JSON 类型（MySQL 5.7+/PostgreSQL），应优先使用数据库原生 JSON 支持 + Laravel 的casts，而非手动json_decode。
通过以上方式，你不仅能精准输出 data_1: 4 等格式化内容，还能构建出更健壮、可维护的 Laravel 应用结构。
