PAYATHON 2026

React 中两次 setState 之间为何出现中间渲染并触发额外 API 请求

数据小陈

出现两次请求,原因是 handleAddressChange 里的几次状态更新没有合并成一次批处理。React 并没有主动在这两个 setState 之间渲染。第一次提交只把 addressParams 换成 Alabama,page 仍是滚动后的 2,所以 searchParams 变成 page

,查询 hook 就发了请求;第二次提交才把 page 重置为 0,searchParams 又变成 page
,于是再发一次请求。日志里的 currentPage
是回调闭包里的旧 page,不是提交时的真实 page。

会出现这种情况,通常是下面几种原因:

  • 状态更新发生在 Google Maps 回调或原生回调里,或者项目还在用 ReactDOM.render/React 17,导致 setAddressParams、setPage、setAccumulatedRows 没有合并。
  • searchParams 依赖 addressParams 和 page,其中任何一个变化都会让 searchParams 的引用变,查询 hook 就会认为参数变了。
  • handleAddressChange 可能来自早期渲染,闭包里的 page 还是 0,所以日志看起来会误导。

修复方式是把地址、page、sortDirection(以及 accumulatedRows)合并到一个 state,或者改用 useReducer,让地址变化成为一次原子更新。

type SearchState = {
  addressParams: AdvancedSearchAddressPayload & { formattedAddress: string };
  page: number;
  sortDirection: SortDirection;
  accumulatedRows: EnphaseSystemTableRow[];
};

const [state, setState] = useState<SearchState>(() => ({
  addressParams: convertToAddressPayload(initialAddress),
  page: 0,
  sortDirection: SortDirection.ASC,
  accumulatedRows: [],
}));

const { addressParams, page, sortDirection, accumulatedRows } = state;

const searchParams = useMemo(() => ({
  searchBy: 'address' as const,
  address: addressParams,
  page: page + 1,
  size: 20,
  sortBy: sortDirection === SortDirection.ASC ? 'id' : '-id',
}), [addressParams, page, sortDirection]);

const handleAddressChange = (newAddress: EnphaseAddressParams) => {
  setState(prev => ({
    ...prev,
    addressParams: convertToAddressPayload(newAddress),
    page: 0,
    accumulatedRows: [],
  }));
};

const handleSortChange = useCallback((_columnId: string, direction: SortDirection) => {
  setState(prev => ({
    ...prev,
    sortDirection: direction,
    page: 0,
    accumulatedRows: [],
  }));
}, []);

const fetchNextPage = () => {
  if (!hasMore || query.isFetching) return;
  setState(prev => ({ ...prev, page: prev.page + 1 }));
};

如果必须保留多个 useState,而且项目仍在 React 17 或 legacy root 下,可以用 unstable_batchedUpdates 包住这几次更新:

import { unstable_batchedUpdates } from 'react-dom';

const handleAddressChange = (newAddress: EnphaseAddressParams) => {
  unstable_batchedUpdates(() => {
    setAddressParams(convertToAddressPayload(newAddress));
    setPage(0);
    setAccumulatedRows([]);
  });
};

如果使用 React 18 createRoot,自动批处理默认会合并同一回调中的更新。若仍出现中间请求,优先检查是否还在用 ReactDOM.render、是否加载了多个 React 副本,或者是否在 Google Maps 回调链中调用了 flushSync。不要用 flushSync 解决重复请求,它只会强制同步提交,通常会让问题更明显。

另外,handleAddressChange 里的 currentPage

说明回调可能只被 Google Maps 注册了一次,闭包一直指向初始 page。要让外部回调调用最新函数,可以用 ref 保存最新 handler,或在地址选择回调中重新绑定。

备注:内容仅供参考。