当从数据库读取的JSON字段本身仍是JSON字符串（而非已解析的数组），直接对json_decode()结果使用foreach会因传入非数组/对象而报错“Invalid argument supplied for foreach()”。需识别并处理双重编码问题。
当从数据库读取的json字段本身仍是json字符串（而非已解析的数组），直接对`json_decode()`结果使用`foreach`会因传入非数组/对象而报错“invalid argument supplied for foreach()”。需识别并处理双重编码问题。
在PHP开发中，尤其是与数据库交互时，常遇到一种隐蔽但高频的错误：Invalid argument supplied for foreach()。该错误表面看是循环参数类型错误，根源却往往在于JSON数据被意外双重编码（double-encoded）。
你遇到的情况正是典型示例：
{"answer":"从建筑PDF提取结构化数据。将规格、BOM、进度表及报告转为Excel/CSV/JSON。扫描件用OCR，原生PDF用pdfplumber。"}
- 数据库字段 fldRawFiles 存储的是一个 JSON 字符串（如 {"6":{...}}）；
- 你执行了 $selectedFiles = json_decode($runStatus['fldRawFiles'], true)；
- 但 echo $selectedFiles 仍输出原始 JSON 字符串（而非 PHP 数组），说明 json_decode() 实际返回了 null —— 因为输入并非合法 JSON，而是已被转义或重复序列化的字符串。
? 关键诊断技巧：
不要仅依赖 echo，应使用 var_dump($selectedFiles) 或 gettype($selectedFiles) 检查真实类型：
$selectedFiles = json_decode($runStatus['fldRawFiles'], true);
var_dump($selectedFiles); // 若输出 string(56) "{"6":{...}}"，说明未成功解码
✅ 正确解决方案：二次解码
当确认 $selectedFiles 仍是 JSON 字符串（即 is_string($selectedFiles) && is_json($selectedFiles) 成立），需再次调用 json_decode()：
// 第一次解码：从数据库字符串 → PHP字符串（含JSON内容）
$rawJsonString = $runStatus['fldRawFiles']; // '{"6":{"files":[],...}}'
// 第二次解码：将内层JSON字符串 → 关联数组
$selectedFiles = json_decode(json_decode($rawJsonString, true), true);
// 现在可安全遍历
foreach ($selectedFiles as $key => $data) {
$programname = $this->extractor_model->get_program_name($key);
// 处理 files, packages, scripts...
}
⚠️ 注意事项：
- 始终验证解码结果：json_last_error() === JSON_ERROR_NONE 是安全前提；
- 避免强制类型转换：(array) json_decode(...) 对 null 或字符串无效，且会丢失原始键名（如 "6" 变成索引 0）；
-
预防胜于修复：入库前确保数据未被重复 json_encode()；可在模型层增加校验逻辑，例如：
if (is_string($value) && !is_array(json_decode($value, true))) { throw new InvalidArgumentException('Invalid double-encoded JSON in fldRawFiles'); }
? 总结：Invalid argument supplied for foreach() 在 JSON 场景下，90% 源于「预期是数组，实为未解码的 JSON 字符串」。养成 var_dump + json_last_error 的调试习惯，优先检查数据流源头（数据库存储格式、ORM 序列化行为、API 响应处理），才能一劳永逸规避此类陷阱。
