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,或在地址选择回调中重新绑定。备注:内容仅供参考。
