Laravel 9 安全解析 JSON 数组字段方法

本文详解 Laravel 9 中因数据库多行数据中仅部分含有效 JSON 导致 json_decode() 返回 null，进而引发“Trying to access array offset on value of type null”错误的根本原因与解决方案。

本文详解 Laravel 9 中因数据库多行数据中仅部分含有效 JSON 导致 `json_decode()` 返回 `null`，进而引发“Trying to access array offset on value of type null”错误的根本原因与解决方案。

在 Laravel 9 开发中，常需从数据库字段（如 JSON 或 TEXT 类型）读取并解析 JSON 字符串为 PHP 数组。例如，某字段存储如下 JSON 数据：

["16502735051.jpg","16502735052.jpg","16502735053.jpg","16502735055.jpg"]

使用 json_decode($json) 默认返回 对象（stdClass），而非关联数组。若直接用 $arr[0] 访问，会因类型不匹配报错；但更隐蔽、更常见的错误来源是：数据库中存在多条记录，仅部分记录该字段有合法 JSON 值，其余为空字符串、null 或无效 JSON。

例如，你查询了 3 条记录：

$records = YourModel::all();
foreach ($records as $record) {
    $arr = json_decode($record->images_json); // 若 $record->images_json 为 null/空/非法JSON → $arr === null
    echo $arr[0]; // ❌ 此处对 null 执行数组下标访问 → "Trying to access array offset on value of type null"
}

✅ 正确做法是：始终校验解码结果的有效性，并显式指定返回数组类型：

foreach ($records as $record) {
    $jsonString = $record->images_json;

    // 1. 检查原始值是否为空或非字符串
    if (empty($jsonString) || !is_string($jsonString)) {
        continue; // 或处理默认逻辑，如跳过、设空数组等
    }

    // 2. 安全解码：true 参数强制返回关联数组
    $arr = json_decode($jsonString, true);

    // 3. 验证解码是否成功（避免 null）
    if (json_last_error() !== JSON_ERROR_NONE || !is_array($arr)) {
        \Log::warning('Invalid JSON in record ID: ' . $record->id);
        continue;
    }

    // 4. 现在可安全访问
    if (!empty($arr)) {
        echo $arr[0]; // ✅ 安全输出首个文件名
        // 或遍历所有图片：
        foreach ($arr as $filename) {
            echo '<img src="/storage/' . e($filename) . '" alt="">';
        }
    }
}

? 关键要点总结：

• json_decode($json, true) 的第二个参数 true 必须显式传入，否则返回对象，无法用 $obj[0] 访问；
• 数据库字段可能为 NULL、空字符串或损坏 JSON —— 解码前务必做 empty() 和类型检查；
• 使用 json_last_error() 是判断解码失败的最可靠方式；
• 在 Blade 模板中，建议封装为 Accessor（模型属性访问器），统一处理逻辑：

// 在 Eloquent 模型中
protected $casts = [
    'images_json' => 'array', // Laravel 自动调用 json_decode(..., true)
];

// 或自定义 accessor（兼容旧版或复杂逻辑）
public function getImagesAttribute()
{
    $json = $this->attributes['images_json'] ?? '';
    return is_string($json) && !empty($json) 
        ? json_decode($json, true) ?: [] 
        : [];
}

然后控制器中可直接使用：

$images = $record->images; // 已是安全数组，无需重复校验

遵循以上实践，即可彻底规避因数据不一致导致的运行时致命错误，提升 Laravel 应用的健壮性与可维护性。