react-dom 16.6.3兼容最高AG Grid React版本及useState报错解决咨询

问题根源 #

React 16.6.3（含对应版本的react-dom）未内置React Hooks API（Hooks在React 16.8.0才正式推出），而AG Grid React 24.x及以上版本的组件内部大量依赖Hooks（如useState），因此会出现useState is not a function的错误。你参考的兼容性图表可能忽略了React版本对Hooks的要求，导致误判适配版本。

可行解决方案 #

方案1：保持React 16.6.3版本 #

最高只能使用AG Grid React 23.x系列的最新版本（推荐23.3.2，是23系列的最终稳定版），该版本的AG Grid React组件基于类组件实现，不依赖Hooks，可兼容React 16.6.3。

回退版本的命令：

npm install ag-grid-react@23.3.2 ag-grid-community@23.3.2
# 或使用yarn
yarn add ag-grid-react@23.3.2 ag-grid-community@23.3.2

方案2：升级React以适配更高版本AG Grid #

将React核心包和react-dom同时升级到16.8.0及以上（推荐升级到16.x系列的最新稳定版16.14.0，或17.x版本），之后即可正常使用AG Grid React 27.1.0（或更高的兼容版本）。

升级命令示例：

npm install react@16.14.0 react-dom@16.14.0
# 或使用yarn
yarn add react@16.14.0 react-dom@16.14.0

升级后需确保项目中所有依赖的React组件都能适配新的React版本，避免其他兼容性问题。

内容的提问来源于stack exchange，提问作者M. Gamie