GraphQL响应转为可迭代JSON数组的完整解决方案

2次阅读

GraphQL响应转为可迭代JSON数组的完整解决方案

本文详解如何将shopify graphql api返回的多段json字符串正确解析为javascript可遍历的json对象数组,解决因php端`print_r()`或未统一编码导致的前端无法用`graphql[i].data.product.id`访问数据的问题。

在使用Shopify GraphQL API进行商品搜索时,一个常见却容易被忽视的问题是:后端返回的并非标准jsON数组,而是多个独立json对象拼接而成的字符串(如用逗号分隔但无外层方括号)。这会导致前端通过 response.json() 解析后得到一个字符串数组(每个元素仍是JSON格式字符串),而非真正的对象数组——因此直接访问 graphQL[i].data.product.id 会返回 undefined

问题根源在于你的 PHP 脚本末尾使用了:

$json = json_encode($restCallArray); print_r($json);

⚠️ print_r() 会以可读格式输出(含换行、空格、甚至可能触发HTML实体转义),破坏JSON结构的合法性;更关键的是,若 $restCallArray 中存储的是原始curl响应字符串(尤其是启用了 “flag” 模式返回未解析的原始响应),那么 json_encode($restCallArray) 实际上是对一组已含完整JSON结构的字符串再次编码,最终生成的是类似:

["{"data":{"product":{...}}}", "{"data":{"product":{...}}}", ...]

即:一个字符串数组,每个元素是JSON字符串,而非解析后的对象。

✅ 正确做法:PHP端应返回标准json数组

修改你的 PHP 脚本第4b部分,避免二次编码 + 确保统一解析

// ✅ 正确:先解析每个GraphQL响应,再统一编码为JSON数组 $products = []; foreach ($graphQLArray as $query) {     $rawResponse = graphQLCall($query, $endpoint, "flag"); // 获取原始响应字符串     $parsed = json_decode($rawResponse, true); // 强制关联数组,便于调试     if (json_last_error() === JSON_ERROR_NONE && isset($parsed['data']['product'])) {         $products[] = $parsed; // 直接推入已解析的对象     } }  // ⚠️ 关键:直接输出标准JSON,不用 print_r() header('Content-Type: application/json; charset=utf-8'); echo json_encode($products, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); exit;

? 提示:json_encode(…, JSON_UNESCAPED_UNICODE) 可防止中文被转义;JSON_PRETTY_PRINT 仅用于调试,上线建议移除以减小体积。

✅ 前端JS:无需 JSON.parse(),直接安全遍历

此时,前端 showGraphQL 函数可大幅简化且更健壮:

async function showGraphQL(shopCode, search) {     try {         const response = await fetch(`../models/ajaxcall.php?shop=${shopCode}&searchString=${search}`);          if (!response.ok) {             throw new Error(`HTTP error! status: ${response.status}`);         }          const products = await response.json(); // ✅ 直接得到对象数组          // 安全遍历(带存在性检查)         products.forEach((item, index) => {             if (item?.data?.product) {                 const { id, title, images } = item.data.product;                 const imgSrc = images?.edges?.[0]?.node?.originalSrc || '/placeholder.jpg';                  console.log(`[${index}] ID: ${id}, Title: ${title}, Image: ${imgSrc}`);                  // ✨ 示例:动态生成HTML列表项                 const li = document.createElement('li');                 li.innerHTML = `                     

${title}

@@##@@ ID: ${id} `; document.getElementById('product-list').appendChild(li); } }); } catch (error) { console.error('GraphQL fetch failed:', error); alert('商品加载失败,请检查网络或搜索关键词'); } }

? 验证与调试建议

  1. 浏览器开发者工具 → Network 标签页:点击对应请求,查看 Response 内容是否为合法JSON数组(以 [ 开头,每个元素是 {…} 对象,无多余引号或换行乱码);
  2. 在PHP中临时加入 error_log(print_r($products, true)); 查看服务端实际输出结构;
  3. 前端添加类型校验:
    console.log('Type of products:', Array.isArray(products), 'First item:', products[0]);

? 总结关键原则

  • 后端职责:负责将原始GraphQL响应统一解析、清洗、组装为标准JSON数组,并通过 echo json_encode(…) 输出,禁用 print_r()/var_dump()
  • 前端职责:信任 response.json() 结果,专注业务逻辑;对嵌套属性使用可选链(?.)和空值合并(??)提升鲁棒性;
  • ❌ 避免“双重解析”陷阱:不要在PHP中 json_encode() 已是JSON字符串的内容,也不要前端对已解析对象再调用 JSON.parse()。

遵循以上结构化处理,你将获得真正可迭代、可预测、易维护的GraphQL数据流——从此告别 undefined 困扰,高效构建动态商品展示界面。

GraphQL响应转为可迭代JSON数组的完整解决方案

text=ZqhQzanResources