Office JS Excel插件集成Redux在2016/2019版本报错求助

你遇到的问题源于Excel 2019和2016使用的旧版Office JS运行时对初始化时机的要求比Office 365更严格。虽然Office.onReady在新版环境中有效，但旧版本仍依赖显式的Office.initialize回调来确认加载完成，同时Redux相关逻辑的提前执行可能触发了未就绪的Office API调用。

修复方案 #

1. 兼容新旧版本的初始化逻辑 #

同时实现Office.initialize和Office.onReady，覆盖旧版本的初始化要求，避免因回调缺失导致的加载检测失败。

2. 确保Redux组件延迟渲染 #

保证包含Redux Provider的组件树仅在Office完全初始化后渲染，防止组件内部的useDispatch/useSelector钩子提前执行依赖Office环境的逻辑。

修改后的完整代码 #

import { AppContainer } from "react-hot-loader";
import { initializeIcons } from "@fluentui/font-icons-mdl2";
import { ThemeProvider } from "@fluentui/react";
import * as React from "react";
import * as ReactDOM from "react-dom";
import App from "./components/App";
import { Provider } from "react-redux";
import store from "./store";
import './taskpane.css'

/* global Excel, Office */

initializeIcons();

let isOfficeInitialized = false;
const title = "Contoso Task Pane Add-in";

const render = (Component) => {
  ReactDOM.render(
    <AppContainer>
      <ThemeProvider>
        <Provider store={store}>
          <Component title={title} isOfficeInitialized={isOfficeInitialized} />
        </Provider>
      </ThemeProvider>
    </AppContainer>,
    document.getElementById("container")
  );
};

// 适配Excel 2016/2019的旧版初始化回调
Office.initialize = (reason) => {
  isOfficeInitialized = true;
  render(App);
};

// 适配Office 365的新版初始化逻辑，避免重复渲染
Office.onReady(() => {
  if (!isOfficeInitialized) {
    isOfficeInitialized = true;
    render(App);
  }
});

if ((module as any).hot) {
  (module as any).hot.accept("./components/App", () => {
    const NextApp = require("./components/App").default;
    render(NextApp);
  });
}

额外排查点 #

• 检查你的store.js文件，如果其中包含直接调用Office API的逻辑，必须将这部分逻辑移到Office初始化完成后执行（比如在App组件的useEffect中触发，或通过dispatch异步action实现）。旧版Office JS不允许在初始化完成前调用任何API，而Redux store的同步初始化会在import时立即执行，这可能是触发错误的核心原因。
• 确认Excel 2016/2019已通过Office更新通道升级到最新可用版本，确保Office JS运行时处于较新状态。

内容的提问来源于stack exchange，提问作者Poojan3037