如何在 React 中使用 Axios 一次性获取 API 的全部分页数据

霞舞

霞舞

2026-07-22

474人浏览

原创

如何在 React 中使用 Axios 一次性获取 API 的全部分页数据

本文介绍如何通过递归式请求和状态驱动的 useeffect 实现自动遍历多页 api 数据,避免手动翻页,确保一次性加载全部结果(如 13 条数据分 2 页返回)。

本文介绍如何通过递归式请求和状态驱动的 useeffect 实现自动遍历多页 api 数据,避免手动翻页,确保一次性加载全部结果(如 13 条数据分 2 页返回)。

在 React 应用中调用分页 API(如 Laravel Sanctum 或 Laravel API Resource 分页响应)时,单次 axios.get('/jobs') 仅返回第一页数据(例如 10 条),而真实数据可能分布在多页中(如 total: 13, last_page: 2)。要一次性获取全部数据,不能依赖静态页码循环(如 for (let i = 1; i 响应驱动的链式请求策略:利用 API 返回的 next_page_url 动态发起下一页请求,直到该字段为 null。

✅ 核心实现思路

  • 使用两个状态变量:data 存储累积结果,nextPageUrl 控制请求流程;
  • 将 nextPageUrl 设为 useEffect 的依赖项,每次更新后自动触发新请求;
  • 每次成功响应后,将新数据合并进 data,并更新 nextPageUrl 为 response.data.next_page_url;
  • 当 nextPageUrl 为 null 或 undefined 时,请求自然终止。

? 完整代码示例

import React, { useState, useEffect } from 'react';
import { getJobsByURL } from '../service/jobs'; // 修改后的服务函数

const MyTable = () => {
  const [data, setData] = useState<any>([]);
  const [nextPageUrl, setNextPageUrl] = useState<string null>(
    'http://api/api/v1/jobs?page=1'
  );
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState<string null>(null);

  useEffect(() => {
    if (!nextPageUrl) {
      setLoading(false);
      return;
    }

    getJobsByURL(nextPageUrl)
      .then((response) => {
        const newData = response.data.data.data || [];
        setData((prev) => [...prev, ...newData]);

        // 关键:从响应中提取下一页 URL(注意字段路径!)
        const nextUrl = response.data.next_page_url;
        setNextPageUrl(nextUrl);
      })
      .catch((e) => {
        console.error('Failed to fetch jobs:', e);
        setError('Failed to load job data');
        setLoading(false);
      });
  }, [nextPageUrl]); // ⚠️ 严格依赖 nextPageUrl,形成链式触发

  // 可选:加载状态提示
  if (loading && data.length === 0) return <div>Loading all jobs...</div>;
  if (error) return <div>Error: {error}</div>;

  return (
    <div>
      {data.map((d, key) => (
        <div key="{key}" classname="d-flex" style="{{" margin:>
          <h3>{d.id}</h3>
          <span style="{{" marginleft:>{d.job_title}</span>
        </div>
      ))}
      {data.length > 0 && (
        <p><strong>Total loaded:</strong> {data.length} jobs</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/shouce/1886" title="React Native For Android 源码编译 中文WORD版"><img
														src="https://img.php.cn/upload/manual/000/000/007/170907841096000.png" alt="React Native For Android 源码编译 中文WORD版" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/shouce/1886" title="React Native For Android 源码编译 中文WORD版" class="overflowclass">React Native For Android 源码编译 中文WORD版</a>
													<p class="overflowclass">本文档主要讲述的是React Native For Android 源码编译;希望对大家会有帮助;感兴趣的朋友可以过来看看</p>
												</div>
												<a rel="nofollow" href="/xiazai/shouce/1886" title="React Native For Android 源码编译 中文WORD版" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
      )}
    </div>
  );
};

export default MyTable;</string></string></any>

对应的服务层需支持传入 URL:

// service/jobs.ts
export function getJobsByURL(url: string) {
  return axiosClient.get(url);
}

⚠️ 关键注意事项

  • 字段路径校验:不同后端分页结构不同。本例中 response.data.next_page_url 来自 Laravel 分页响应;若你的 API 返回 response.data.links.next,请相应调整。
  • 防重复请求:确保 nextPageUrl 更新逻辑无误,避免因 undefined / '' 导致无限请求(建议显式判断 if (nextUrl))。
  • 错误中断处理:任一页面请求失败应停止后续请求(当前示例中 catch 后设 setLoading(false) 并报错)。
  • 性能权衡:对海量数据(如 > 1000 条),建议改用滚动加载或后端提供 ?all=1 参数,避免前端串行请求阻塞渲染。
  • 取消请求(进阶):可结合 AbortController 在组件卸载时取消未完成请求,防止状态更新警告。

✅ 总结

该方案不依赖预知总页数,完全由 API 响应驱动,符合 RESTful 设计原则。它将分页逻辑封装在状态与副作用中,简洁、可维护,并天然适配任意页数的分页接口。只需确保服务端正确返回 next_page_url(或等效字段),即可实现“一键拉取全量数据”的体验。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2434

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

720

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

2227

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

638

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1167

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

2133

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

2415

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

1523

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

500

7

热门下载

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

精品课程

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

共58课时 | 11.1万人学习

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

共12课时 | 1.3万人学习