OfficeJS Word加载项报Maximum Range Call Stack Size错误求助

报错是API调用方式错误导致的，不是OfficeJS本身的不可修复缺陷。
你的代码里通过Promise.all一次性并发发起所有切片的getSliceAsync请求，而OfficeJS的File操作API本身不支持并发调用：

• 当目标文档切片总数较多时，并发请求会直接打满Word客户端内部的跨进程调用栈，触发Maximum Range Call Stack Size Error
• 不同开发人员复现情况不一致，是因为不同版本的Office客户端内部运行时的栈深度限制、默认切片大小配置有差异；特定文档触发报错，是因为这类文档生成的切片总数刚好达到当前环境的并发调用阈值，和文档本身的内容异常、本地缓存没有关系，所以清缓存、排查文档特征都不会有效果。

放弃并发拉取切片的逻辑，改为串行按顺序拉取，每次只发起一个getSliceAsync调用，前一个切片拉取完成后再发起下一个请求，从根源上避免调用栈溢出。
修改后的可直接运行代码如下：

static async getFileContent(): Promise<number[]> {
    console.log('Starting file content retrieval');
    return new Promise((resolve, reject) => {
        Office.context.document.getFileAsync(
            Office.FileType.Compressed,
            async (result) => {
                if (result.status !== Office.AsyncResultStatus.Succeeded) {
                    return reject(`Failed to get file content: ${result?.error?.message}`);
                }

                const file: Office.File = result.value;
                const allSlices: number[][] = [];
                console.log('Slice count: ' + file.sliceCount);

                try {
                    // 按顺序串行拉取所有切片，禁止并发调用
                    for (let sliceIndex = 0; sliceIndex < file.sliceCount; sliceIndex++) {
                        const sliceData = await WordDocumentService.getFileSlice(file, sliceIndex);
                        allSlices.push(sliceData);
                    }
                    console.log('Concatenating data');
                    resolve([].concat(...allSlices));
                } catch (err) {
                    reject(err);
                } finally {
                    // 无论成功失败都确保关闭文件句柄，避免内存泄漏
                    await WordDocumentService.closeOfficeFile(file);
                }
            }
        );
    });
}

static getFileSlice(file: Office.File, sliceIndex: number): Promise<number[]> {
    console.log('Getting file slice: ' + sliceIndex);
    return new Promise((resolve, reject) => {
        return file.getSliceAsync(sliceIndex, (result) => {
            if (result.status === Office.AsyncResultStatus.Succeeded) {
                return resolve(result.value.data);
            } else {
                return reject(
                    `Failed to get file slice ${sliceIndex} from file: ${result?.error?.message}`
                );
            }
        });
    });
}

static closeOfficeFile(file: Office.File): Promise<void> {
    console.log('Closing office file');
    return new Promise((resolve, reject) => {
        return file.closeAsync((result) => {
            if (result.status === Office.AsyncResultStatus.Succeeded) {
                return resolve();
            } else {
                return reject(`Failed to close file: ${result?.error?.message}`);
            }
        });
    });
}

• 如果处理体积超过100MB的超大文档，可以在调用getFileAsync时传入sliceSize参数调大单个切片的大小，减少总切片数量，进一步降低调用压力，示例：

// 指定单个切片大小为16MB，减少总切片数
Office.context.document.getFileAsync(
  Office.FileType.Compressed,
  { sliceSize: 16 * 1024 * 1024 },
  async (result) => { /* 原有逻辑不变 */ }
)

• 如果个别极低版本的Office客户端串行拉取仍偶发报错，可以在两次切片拉取之间加10~20ms的延迟，给客户端留出内部状态清理的时间即可，绝大多数环境不需要加这个延迟。

内容的提问来源于stack exchange，提问作者Isaac N.