React请求JSON报Unexpected token <错误 如何获取数据并渲染列表
报错原因
Uncaught SyntaxError: Unexpected token < in JSON at position 0的核心触发逻辑是:response.json()尝试解析的内容并非JSON格式,而是以<开头的HTML文本(通常是<!DOCTYPE html>或<html>标签)。常见触发场景:
- 请求JSON的路径配置错误,服务器返回404/500状态的HTML错误页
- 静态资源路径匹配错误,SPA fallback逻辑返回了根目录的index.html
- 本地开发时JSON文件未放置在可公开访问的静态资源目录下
正确实现流程
1. 静态资源路径配置
针对CRA/Vite类React项目,需将目标JSON文件放置在项目的public目录下(例如public/survey-test-data.json),禁止放在src目录下通过相对路径发起fetch请求,避免打包后资源路径错位。
若项目部署在非根路径的站点(例如https://xxx.com/feedback/),需通过环境变量拼接请求地址,规避路径匹配错误:
- CRA环境:请求地址拼接为
${process.env.PUBLIC_URL}/survey-test-data.json - Vite环境:请求地址拼接为
${import.meta.env.BASE_URL}survey-test-data.json
2. 带格式校验的fetch逻辑
不要直接链式调用response.json(),需先校验HTTP响应状态与返回内容类型,避免解析非JSON内容时抛出异常:
useEffect(() => { const fetchData = async () => { try { const res = await fetch(`${import.meta.env.BASE_URL}survey-test-data.json`); // 校验HTTP响应状态 if (!res.ok) throw new Error(`请求失败,状态码:${res.status}`); // 校验返回内容类型为JSON const contentType = res.headers.get('content-type'); if (!contentType?.includes('application/json')) { const rawText = await res.text(); throw new Error(`返回格式非JSON,内容开头:${rawText.slice(0, 50)}`); } const parsedData = await res.json(); setQuestionList(parsedData.data.questions); setBaseInfo(parsedData.data); } catch (err) { setError(err.message); } finally { setLoading(false); } }; fetchData(); }, []);
3. 列表展示组件完整实现
补充加载、错误状态处理,避免空值访问报错:
import { useState, useEffect } from 'react'; const SurveyDataDisplay = () => { const [baseInfo, setBaseInfo] = useState(null); const [questionList, setQuestionList] = useState([]); const [loading, setLoading] = useState(true); const [error, setError] = useState(''); useEffect(() => { const loadData = async () => { try { const res = await fetch(`${import.meta.env.BASE_URL}survey-test-data.json`); if (!res.ok) throw new Error(`请求失败,状态码:${res.status}`); const contentType = res.headers.get('content-type'); if (!contentType?.includes('application/json')) { const rawText = await res.text(); throw new Error(`返回格式非JSON,内容开头:${rawText.substring(0, 30)}`); } const resData = await res.json(); setBaseInfo(resData.data); setQuestionList(resData.data.questions); } catch (err) { setError(err.message); } finally { setLoading(false); } }; loadData(); }, []); if (loading) return <div>数据加载中...</div>; if (error) return <div>加载失败:{error}</div>; return ( <div style={{ padding: '20px' }}> <div> <h3>基础信息</h3> <p>UUID:{baseInfo.uuid}</p> <p>数据集名称:{baseInfo.name}</p> <p>默认语言:{baseInfo.default_language}</p> <p>创建时间:{baseInfo.created_at}</p> </div> <h3>问题列表</h3> <ul> {questionList.map(item => ( <li key={item.id} style={{ margin: '10px 0' }}> <span>问题ID:{item.id}</span> <span style={{ margin: '0 10px' }}>问题名称:{item.name}</span> <span style={{ margin: '0 10px' }}>类型:{item.type}</span> <span style={{ margin: '0 10px' }}>是否自定义:{item.custom ? '是' : '否'}</span> <span style={{ margin: '0 10px' }}>排序:{item.order}</span> </li> ))} </ul> </div> ); }; export default SurveyDataDisplay;
替代实现方案
如果JSON为固定静态内容,无需动态请求,可直接将JSON文件放置在src目录下,通过import引入使用,完全规避fetch路径匹配问题:
import surveyData from './survey-test-data.json'; // 直接通过surveyData.data.questions读取数据即可
注意事项
- 禁止通过
file://协议直接打开打包后的HTML文件调试,浏览器安全策略会拦截本地fetch请求,必须通过本地开发服务器或HTTP服务环境访问 - 若请求跨域接口时出现该报错,通常是跨域被拦截后返回了HTML错误页,需配置本地代理或后端放开跨域访问权限
内容的提问来源于stack exchange,提问作者CodeMan
相关产品推荐
相关产品推荐

