查询重试 Query Retries

当useQuery查询失败（查询函数引发错误）时，如果该查询的请求未达到最大连续重试次数（默认 3 次），或者未提供函数来确定是否允许重试，那么 React Query 将自动重试该查询。

你可以在全局级别或者单个查询级别上配置重试逻辑。

设置retry = false将禁用重试
设置retry = 6该函数抛出最终错误前，将重试 6 次
设置retry = true将无限次重试失败的请求
设置retry =（failureCount，error）=> ...允许基于请求失败的原因进行自定义逻辑

import { useQuery } from "@tanstack/react-query";

// 对特定的一个查询设置固定的重试次数
const result = useQuery({
  queryKey: ["todos", 1],
  queryFn: fetchTodoListPage,
  retry: 10, // 在显示错误之前，将重试10次
});

重试延迟

默认情况下，React Query 不会在请求失败后立即重试。按照标准，后退延迟将逐渐应用于每次重试。

默认的retryDelay设置为以二的倍数递增（从1000ms开始），但不超过 30 秒：

// 为所有查询配置
import {
  QueryCache,
  QueryClient,
  QueryClientProvider,
} from "@tanstack/react-query";

const queryClient = new QueryClient({
  defaultOptions: {
    queries: {
      retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),
    },
  },
});

function App() {
  return <QueryClientProvider client={queryClient}>...</QueryClientProvider>;
}

尽管不建议这样做，但是显然你可以在 Provider 和单个查询选项中覆盖retryDelay函数/整数。如果设置为一个整数而不是函数，则重试之间的延迟将始终是相同的时间量：

const result = useQuery({
  queryKey: ['todos'],
  queryFn: fetchTodoList,
  retryDelay: 1000, // 无论重试多少次，都会始终等待1000毫秒然后重试
});

重试延迟​

重试延迟