Recharts 图表不渲染?解决数据状态更新时序错误导致的初始加载失败问题

千强酱_1964

千强酱_1964

2025-12-30

495人浏览

原创

Recharts 图表不渲染?解决数据状态更新时序错误导致的初始加载失败问题

recharts 图表在页面首次加载时不显示,仅在手动保存文件(触发热重载)后才出现,根本原因是 `usestate` 状态更新异步特性被误用:在 `setyearlydata` 后立即访问旧值 `yearlydata[index]`,导致 `monthlydata` 被设为 `undefined`,图表因空数据无法渲染。

这个问题本质是 React 状态更新的时序陷阱:useState 的 setter 函数(如 setYearlyData)是异步的,它不会立即改变当前作用域中的变量值,而是调度一次重新渲染,并在下一次组件执行时才提供更新后的状态值。

在你的代码中:

const getActivity = async (index) => {
  const res = await api.get("/activity");
  const data = res?.data;
  setYearlyData(data);
  setMonthlyData(yearlyData[index]); // ❌ 错误!此时 yearlyData 仍是初始值(如 [] 或 undefined)
};

由于 yearlyData 在 setYearlyData(data) 调用后并未立刻更新,yearlyData[index] 实际取到的是初始空数组或 undefined,最终 monthlyData 被设为 undefined。而 接收 undefined 或空数组时会静默失败(不报错但不渲染线条),造成“图表消失”的假象。当你按 Ctrl+S 触发热重载时,组件重新挂载并执行 useEffect,此时若 yearlyData 已缓存(如 Vite HMR 保留了部分状态),可能偶然“生效”,进一步掩盖问题。

✅ 正确做法:直接使用刚获取的 data 构建 monthlyData,而非依赖尚未更新的 yearlyData

const getActivity = async (index) => {
  try {
    const res = await api.get("/activity");
    const data = res?.data || [];
    setYearlyData(data);
    // ✅ 正确:用本次 fetch 到的 data 计算 monthlyData
    if (Array.isArray(data) && data.length > index) {
      setMonthlyData(data[index]);
    } else {
      setMonthlyData([]); // 降级处理
    }
  } catch (error) {
    console.error("Failed to fetch activity data:", error);
    setMonthlyData([]);
  }
};

? 进阶建议:

Vitest Testing
Vitest Testing

Vitest 测试框架模式与最佳实践。适用于编写单元测试、集成测试、配置 vitest.config、使用 vi.mock/vi.fn 进行模拟等...

下载
  • 初始化状态更明确:将 yearlyData 初始值设为 null 而非 [],可让 yearlyData[index] 报 TypeError,便于早期发现错误:

    const [yearlyData, setYearlyData] = useState(null); // 而非 useState([])
  • 避免重复计算:若 monthlyData 仅由 yearlyData 和 index 派生,推荐使用 useMemo 派生状态,减少冗余 setState:

    const [yearlyData, setYearlyData] = useState(null);
    const [activeIndex, setActiveIndex] = useState(0);
    
    useEffect(() => {
      const fetchActivity = async () => {
        const res = await api.get("/activity");
        setYearlyData(res?.data || []);
      };
      fetchActivity();
    }, []);
    
    // 派生 monthlyData,自动响应 yearlyData 和 activeIndex 变化
    const monthlyData = useMemo(() => {
      return yearlyData?.[activeIndex] ?? [];
    }, [yearlyData, activeIndex]);

⚠️ 注意事项:

  • 不要在 useEffect 中同时设置多个强依赖的状态(如先 setYearlyData 再 setMonthlyData 依赖它),这容易引发竞态和时序 bug;优先使用派生状态或直接数据流。
  • Recharts 对 data 属性要求严格:必须是非空数组且每个对象需包含 XAxis.dataKey(如 "name")和 Line.dataKey(如 "user")对应的字段,否则静默忽略。可在渲染前添加校验:
    {(!monthlyData || monthlyData.length === 0) && (
      <div classname="text-gray-500 text-sm">暂无数据</div>
    )}

通过修正状态更新逻辑,图表将在首次加载时正确渲染,彻底告别“Ctrl+S 才显示”的调试困境。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

react vite echarts 作用域

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

569

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

undefined是什么
undefined是什么

undefined是代表一个值或变量不存在或未定义的状态。它可以作为默认值来判断一个变量是否已经被赋值,也可以用于设置默认参数值。尽管在不同的编程语言中,undefined可能具有不同的含义和用法,但理解undefined的概念可以帮助我们更好地理解和编写程序。本专题为大家提供undefined相关的各种文章、以及下载和课程。

2023.07.31

12445

4

网页undefined是什么意思
网页undefined是什么意思

网页undefined是指页面出现了未知错误的意思,提示undefined一般是在开发网站的时候定义不正确或是转换不正确,或是找不到定义才会提示undefined未定义这个错误。想了解更多的相关内容,可以阅读本专题下面的文章。

2024.08.14

5567

7

网页undefined啥意思
网页undefined啥意思

本专题整合了undefined相关内容,阅读下面的文章了解更多详细内容。后续继续更新。

2025.12.25

2536

7

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.5万人学习