查询重试
当一个 useQuery 查询失败（查询函数抛出错误）时，若该查询请求尚未达到连续重试次数上限（默认为 3 次），或你提供了用于判断是否允许重试的函数，TanStack Query 将自动重试该查询。
你可以在全局层面和单个查询层面分别配置重试行为。
- 设置
retry = false将禁用重试。 - 设置
retry = 6将在显示查询函数最终抛出的错误前，对失败请求重试 6 次。 - 设置
retry = true将无限次重试失败请求。 - 设置
retry = (failureCount, error) => ...可基于请求失败原因实现自定义逻辑。注意：failureCount在首次重试尝试时从0开始计数。
在服务端，重试默认设为
0次，以使服务端渲染尽可能快。
TypeScript
1import { useQuery } from '@tanstack/react-query'2 3// Make a specific query retry a certain number of times4const result = useQuery({5 queryKey: ['todos', 1],6 queryFn: fetchTodoListPage,7 retry: 10, // Will retry failed requests 10 times before displaying an error8})说明：
error属性的内容将在useQuery的failureReason响应属性中持续存在，直至最后一次重试尝试。因此，在上述示例中，任何错误内容将在前 9 次重试尝试（总计 10 次尝试）期间作为failureReason属性的一部分；若所有重试尝试后错误依然存在，则最终该错误内容将归入error属性。
重试延迟
默认情况下，TanStack Query 的重试不会在请求失败后立即发生。与标准实践一致，每次重试尝试都会逐步应用指数退避延迟。
默认 retryDelay 被设为每次尝试时加倍（起始值为 1000ms），但不超过 30 秒：
TypeScript
1// Configure for all queries2import {3 QueryCache,4 QueryClient,5 QueryClientProvider,6} from '@tanstack/react-query'7 8const queryClient = new QueryClient({9 defaultOptions: {10 queries: {11 retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),12 },13 },14})15 16function App() {17 return <QueryClientProvider client={queryClient}>...</QueryClientProvider>18}尽管不推荐，你显然可在 Provider 和单个查询选项中覆盖 retryDelay（函数或整数值）。若将其设为整数而非函数，则每次延迟时间将保持恒定：
TypeScript
1const result = useQuery({2 queryKey: ['todos'],3 queryFn: fetchTodoList,4 retryDelay: 1000, // Will always wait 1000ms to retry, regardless of how many retries5})后台重试行为
当使用 refetchInterval 配合 refetchIntervalInBackground: true 时，若浏览器标签页处于非活跃状态，重试将暂停。这是因为重试遵循与常规重新拉取（refetch）相同的焦点行为。
若你需要后台持续重试，可考虑禁用重试并实现自定义重新拉取策略：
TypeScript
1const result = useQuery({2 queryKey: ['todos'],3 queryFn: fetchTodos,4 refetchInterval: (query) => {5 // Refetch more frequently when in error state6 return query.state.status === 'error' ? 5000 : 300007 },8 refetchIntervalInBackground: true,9 retry: false, // Disable built-in retries10})该方法让你能手动控制重试时机，同时保持后台重新拉取的活跃状态。