Material-React-Table 排序回调重复触发问题解析

问题现象

在使用 Material-React-Table 组件时，开发者发现 onSortingChange 回调函数在表格首次渲染时会被调用两次。这是一个常见但容易被忽视的问题，特别是在处理表格排序状态时。

问题本质

这个问题的根源在于状态管理的使用方式不当。Material-React-Table 是一个受控组件，它的状态管理需要遵循特定的模式。开发者直接通过 onSortingChange 回调来触发副作用（如 API 调用），而没有正确理解 React 状态更新的异步特性。

正确解决方案

正确的做法应该是：

1. 首先将排序状态提升到父组件（状态提升）
2. 然后使用 React 的 useEffect 来监听排序状态的变化
3. 在 useEffect 中执行相关的副作用操作

这种模式符合 React 的最佳实践，能够确保状态更新和副作用执行的顺序正确。

代码实现示例

const [sorting, setSorting] = useState<SortingState>([]);

// 正确的方式：使用useEffect监听排序状态变化
useEffect(() => {
  // 在这里执行API调用或其他副作用
  console.log('排序状态变化:', sorting);
}, [sorting]);

return (
  <MaterialReactTable
    columns={columns}
    data={data}
    state={{ sorting }}
    onSortingChange={setSorting} // 仅用于状态提升
  />
);

为什么原始方案会触发两次

原始实现中直接在 onSortingChange 中执行副作用会导致：

1. 表格初始化时会设置默认排序状态
2. React 的严格模式在开发环境下会故意双重调用某些函数以检测问题
3. 状态更新和副作用混合在一起，难以控制执行顺序

最佳实践建议

1. 始终将表格状态提升到父组件
2. 使用 React 的 useEffect 来处理副作用
3. 避免在状态更新回调中直接执行副作用
4. 考虑添加防抖机制处理频繁的排序变化

通过遵循这些原则，可以避免回调重复触发的问题，并使代码更加健壮和可维护。

总结

Material-React-Table 是一个功能强大的表格组件，但需要正确理解其状态管理机制。排序回调重复触发的问题实际上反映了 React 状态管理的基本原理，通过采用正确的模式，不仅可以解决当前问题，还能为更复杂的功能实现打下良好基础。