本文档主要汇总 FineBI For Excel 插件的常见问题和解决方案，如下表所示：

2.1 插件版本过高，需升级系统

问题描述：

提示：插件版本过高，需升级系统。

解决方案：

FineBI 版本需要为 5.1.12 及以上才能安装插件，若版本过低需要先升级 FineBI ，检查FineBI版本参见： FineBI 版本 。

2.2 文件上传失败

问题描述：

上传插件时提示：文件上传失败。

解决方案：

请按以下步骤操作：

1）点击 F12 打开开发者调试页面后再点击「 Network」按钮。

2）重新上传插件，若 network 页面中返回了报错信息:  Request Entity Too Large , 说明需要修改 Nginx 的文件限制大小，详细操作请参见:  nginx 常见报错及解决方案。

2.3 插件安装无反应

问题描述：

插件安装后无反应，不显示进度条，不显示安装完成。

解决方案：

多次刷新浏览器、重新安装插件、或者再等待一段时间。可参见 插件管理 进行排查，若不能处理，可点击界面右侧按钮联系帆软技术支持。

3.1 报错：FineBI5.1/excel/FineBIForExcel.vsto

问题描述：

插件安装过程中报错有如下提示：FineBI5.1/excel/FineBIForExcel.vsto

原因分析：

缺少运行环境。

解决方案：

下载 FineBI For Excel运行环境，解压后，点击修复，按照提示完成修复步骤，再双击安装 Excel 插件客户端插件。

（FineBI For Excel 运行环境的教程可参见： 教程视频）

3.2 权限问题

问题描述：

安装过程中遇到权限问题。

解决方案：

右击以管理员身份运行安装。

3.3 安装过程中有杀毒软件警告或阻止

问题描述：

插件安装过程中有杀毒软件警告或阻止安装或提示请检查您是否有足够的权限访问该项，如下图所示：

原因分析：

杀毒软件阻止注册文件写入。

解决方案1：

将杀毒软件退出后重新安装插件。

解决方案2：

当无法退出杀毒软件时，可关闭注册表防护，如 360 卫士关闭注册表路径：「安全防护中心>进入防护>关闭注册表防护 」，如下图所示：

3.4 Excel 顶端无「 FineBI 」标签

问题描述：

首次安装完毕后或者成功安装过但后来打开 Excel，Excel 顶端无「 FineBI 」标签，如下图所示：

解决方案：

请按以下步骤操作：

1）检查环境中是否安装有天锐绿盾，若有需要找 IT 调整天锐绿盾防护策略，允许 Excel 安装插件。

注：若 Excel 文件上有一把小锁，通常是有防护软件，常用的是绿盾，需要找 IT 调整下防护策略。

2）点击「文件>账户」，确定 Excel 已激活，未激活的 Excel 无法安装插件，如下图所示：

3）点击「控制面板>程序卸载> FineBI For Excel 」检查是否已安装客户端，若未安装，重新安装 Excel 客户端，如下图所示：

4）打开 Excel，点击「文件>选项>加载项」，管理中选择「禁用项目」，查看插件是否被禁用，若被禁用，点击启用插件，关掉 Excel 后重新打开查看是否有 FineBI 标识，如下图所示：

5）管理中选择「COM 加载项」，查看 Excel 插件是否未加载，若未加载，勾选后点击确定，查看是否有 FineBI 标识，然后关掉 Excel 后重新打开 Excel 查看是否有FineBI 标识，如下图所示：

6）使用「 FineBI For Excel 运行环境」进行修复，下载并使用 FineBI For Excel 运行环境 进行修复后，再重新安装插件。

（FineBI For Excel 运行环境的教程可参见 教程视频）

7）查看 Excel 「文件>选项>自定义功能区」，检查主选项卡中是否勾选 FineBI，若未勾选则勾选上，如下图所示：

3.5 版本不匹配，需要升级，安装不上新版本

问题描述：

多次显示版本不匹配，需要升级，安装不上新版本。

原因分析：

安装过 6.2.5 及以下或高于当前服务器新 Excel 插件版本的客户端。

解决方案：

1）点击「控制面板>程序卸载」，搜索 excel，若有两个 Excel 客户端，双击全部卸载，如下图所示：

2）再重新安装 Excel 插件客户端，可参见：Excel插件安装

4.1 登录页面空白

问题描述：

登录插件时，登录页面空白，如下图所示：

解决方案 1：

若用户使用的是 IE 浏览器：

• 检查 IE 浏览器 版本是否为 IE11，若版本低需要先升级浏览器（ IE11 下载链接）

（若用户只能连接内网，升级前需要安装补丁 适用 32 位版本的 windows、适用 64 版本的 windows 安装完补丁后重启电脑，再离线安装升级 IE11）

• 清除 IE 浏览器 缓存后重新登录，若登录还是显示空白，使用解决方案 2。

解决方案 2：

下载 FineBI for Excel运行环境 FineBIForExcel运行环境 .zip ，解压后，点击「安装 Edge 内核」。

安装完毕后重新登录，内置浏览器顶部标签带有（ Edge 内核）则代表 Edge 内核的内置浏览器安装成功，若安装失败，请尝试更新 Windows 系统后重新登录。

4.2 Excel 插件未安装/被禁用，无法使用

问题描述：

登录后提示：Excel插件未安装/被禁用，无法使用。

解决方案：

请按以下步骤操作：

1）找 BI 管理员，检查平台插件是否已安装或启用,保证 Excel 插件是启用状态，如下图所示：

2）检查用户端 BI 地址输入是否正确（BI 地址：BI 新建一个仪表板，截取 /v5 之前的地址），如下图所示：

3）检查客户电脑控制面板中是否有多个 Excel 插件，若有则需要将旧插件卸载，如下图所示：

4）更改 BI 地址中的传输协议，http 改为 https 或者 https 改为 http，如下图所示：

5）检查 BI 安装路径%FineBI\webapps\webroot\WEB-INF\lib下是否有 fine-bi-excel-plugin-5.1.jar，若有则需要将其删除并重启 FineBI 。

注：fine-bi-excel-plugin-5.1.jar 是Excel插件 4.0版本不是插件的形式，首次安装新插件的客户不需要检查。

4.3 Base-64 字符数组或字符串的长度无效

问题描述：

Excel 插件用 Edge 内核登录报错 Base-64 字符数组或字符串的长度无效，如下图所示：

解决方案：

查看控制面板是否安装 Edge 内核，双击卸载 Edge 内核再登录，如下图所示：

4.4 请求服务器数据失败

问题描述：

Excel插件登录时提示：请求服务器数据失败 ，如下图所示：

解决方案：

缺少环境，下载 FineBI for Excel运行环境 FineBIForExcel运行环境 .zip ，解压后，点击修复，按照提示完成修复步骤，再登录。

4.5 无法从 Excel 中访问 FineBI 

问题描述：

Excel 中登录，输入 FineBI 地址后，点击登录没反应。

解决方案：

请按以下步骤操作：

1）若用户使用的是 IE 浏览器：

• 检查 IE 浏览器 版本是否为 IE11，若版本低需要先升级浏览器（ IE11 下载链接）

（若用户只能连接内网，升级前需要安装补丁 适用 32 位版本的 windows、适用 64版本的 windows 安装完补丁后重启电脑，再离线安装升级 IE11）

• 清除 IE 浏览器缓存后重新登录。

2）FineBI 地址输入到 IE 浏览器，查看是否可登录。

3）下载 FineBI for Excel 运行环境  FineBIForExcel 运行环境 .zip ，解压后，点击「安装 Edge 内核」，如下图所示：

4.6 点击「在 Excel 中分析」，无法跳转到 Excel 打开并登录 Excel 插件

问题描述：

在BI数据准备中，点击在 Excel 中分析，弹出 在 Microsoft Store 中查找应用 ，无法跳转到 Excel 打开并登录 Excel 插件，如下图所示：

解决方案：

重置浏览器设置，如下图所示：

4.7 Excel 中登录 Excel 插件，点击预览发布到 FineBI 后，Excel 中又需要登录

问题描述：

在使用 Excel 中登录 Excel 插件中登录账号后，发布到平台时，打开浏览器又需要重新登陆，在平台预览觉得有问题需要回到 Excel调试时，发现插件又需要重新登录。

原因分析：

BI 版本和 Excel 插件不匹配造成的。

解决方案：

Excel 插件 6.3.0 及以上的版本，适配 BI 版本：5.1.17 及以上。

若 5.1.17 及以上安装了 Excel 插件 6.3.0 及以上版本，会造成循环登录的问题。若 Excel 报表做的少，可以回退 Excel 插件版本到6.2.5，回退后需要调整过滤组件部分，会出现部分不兼容；若 Excel 报表的多，建议升级 BI 版本到 5.1.17 及以上版本。

5.1 数据显示不全

问题描述：

点击加载数据，数据显示不全，仅显示前 100 条数据。

原因分析：

未勾选全量数据，仅显示前 100 条数据，如下图所示：

解决方案：

点击勾选全量数据，即可加载数据表中全部数据到 Excel 中。（默认数据加载最大行数不超过 100w）

5.2 【XXX】和【XXX】来源于不同的数据集，不可放在同一 Excel 表格中

问题描述：

点击加载数据，报错：【字段名 A】和【字段名 B】来源于不同的数据集，不可放在同一 Excel 表格中，如下图所示：

原因分析：

一个 sheet 页中，只允许加载 1 张数据表的字段。

解决方案：

将报错字段，在本 sheet 页删除列，拖拽到其他 sheet 页。

5.3 单个 sheet 中不允许使用多个 BI 明细表

问题描述：

点击加载数据表，报错：单个 sheet 中不允许使用多个 BI 明细表，如下图所示：

原因分析：

由于字段拖拽不连续的原因，Excel 认定为存在多个分组表。

解决方案：

观察可以发现，有些中间字段下面出现了小角，表示 Excel 存在多个分组表。

• 若该字段没有被其他表格引用，可以直接删除列重新拖拽

• 若已经被引用做了报表，可在当前明细表的下方间隔几个空行，从左到右依次对应拖入字段，然后通过删除行的方式将之前拖入的字段及空白行删除，例如可以在第四行依次重新拖入字段，再删除 1-3 行，如下图所示：

5.4 数据刷新失败

问题描述：

点击加载表数据，报错：数据刷新失败，如下图所示：

原因分析：

客户端存在多个 FineBI for Excel 程序。

解决方案：

请按以下步骤操作：

1）「控制面板>程序卸载」，查看是否有两个 FineBI for Excel 程序，如下图所示：

2)将两个 FineBI For Excel 程序都卸载，如下图所示：

3）再安装 Excel 插件客户端，可参见：Excel插件安装。

5.5 报错：xxxx Error message is Empty！

问题描述：

加载表数据时报错：xxxx Error message is Empty！

解决方案：

确定用户是否为集群转发环境，若是，可参见 集群转发环境 解决。

5.6 报错：ExcelDateLimitConfig

问题描述：

点击加载表数据，报错：ExcelDateLimitConfig，如下图所示：

原因分析：

服务器未安装成功 Excel 插件。

解决方案：

1）IT 确定 Excel 插件安装的版本，若是 6.4.1 以下的版本，根据升级步骤升级到  6.4.1 ，并重启 FineBI 后清除浏览器缓存。

2）IT 确定 Excel 插件安装的版本，若是 6.4.1 版本，重启 FineBI 并清除浏览器缓存。

5.7  是否勾选「全量数据」，数据都不正常显示

问题描述：

勾选全量数据，点击加载表数据，没反应数据无法加载出来，不勾选全量数据，数据可正常加载前100条，如下图所示：

原因分析：

环境的系统性能计数器损坏，导致我们调用的 windows 系统方法报错。

解决方案：

搜索cmd ，用管理员身份打开，输入 lodctr /R 进行修复，修复性能计数器即可，如下图所示：

5.8  字段值扩展后未自动生成表格，除第一行外其余没有表格背景

问题描述：

点击加载表数据，字段值扩展后未自动生成表格，除第一行外其余行没有表格背景填充。

原因分析：

Excel 配置问题.

解决方案：

在 Excel 中点击「文件>选项>校对>自动更正选项>键入时自动套用格式」，勾选「在表中包含新行和列」，重新加载表数据，如下图所示：

5.9 一直卡在「正在读取表字段信息」

问题描述：

点击加载表数据，一直卡在「正在读取表字段信息」，且预览发布时报错：无法将类型为“System._ComObject”的COM对象强制转化为接口类型xxxxxx，异常来自HRESULT：0x80029C4A（TYPE_E_CANTLOADLIBRARY）

解决方案：

1）确认之前是否安装过 WPS，并将其卸载过。

2）由于 WPS 卸载残留导致 Excel 功能受损，所以需要重新下载安装 WPS 或更新 Excel 版本，比如 Office 2019。

5.10 错误代码：62400001 out of row restriction：XXX

问题描述：

点加载表数据，报错：62400001 out of row restriction：XXX/超过当前excel最大行数限制，如下图所示：

原因分析：

超过 Excel 加载最大数据量限制，默认是 100w。

解决方案：

1）通过筛选，减少加载到Excel中的数据量，可参见：Excel插件-筛选

2）通过自助数据集提前做过滤/分组汇总，可参见：Excel插件-数据准备

3）管理员可通过在工程浏览器界面添加接口 /v5/excel/plugin/data/limit，来限制 Excel 插件加载的数据量，

可参见：Excel插件接口设置

5.11 点击「加载表数据」或者「保留表结构」，没有反应

问题描述：

点击加「加载表数据」或者「保留表结构」，数据不加载/不收起，如下图所示：

解决方案：

点击关于查看 Excel 插件客户端版本，若位 6.4.1 以下（不包含 6.4.1）版本且从 BI 拖拽出来的字段没有行表头，则：

方案1：选中第一行字段名，点击「开始>筛选」，加回行表头后点击加载即可。

方案2：服务器和客户端升级到  6.4.1 版本及以上，推荐方案 2。

5.12 System.OutOfMemoryException

问题描述：

点击加载表数据，报错：System.OutOfMemoryException，如下图所示：

原因分析：

电脑可用内存不足，加载数据量太大。

解决方案：

1）打开任务管理器，检查内存占用，关掉其他程序。

2）减少加载到 Excel 中的数据量，可用筛选或自助数据集提前处理。

问题描述：

Excel 端过滤组件弹窗空白，无法点击添加过滤组件或弹窗中组件布局混乱，如下图所示：

解决方案：

请按以下步骤操作：

1）检查 IE浏览器 版本是否为 IE11，若版本低需要先升级浏览器（IE11下载链接）。（若用户只能连接内网，升级前需要安装补丁 适用32位版本的 windows、适用64版本的 windows 安装完补丁后重启电脑，再离线安装升级 IE11）

2）清除客户IE浏览器缓存后重新打开过滤弹窗。

7.1 错误代码：61300111

问题描述：

预览 Excel 报表时，报错：错误代码 ：61300111 当前系统负载过高，为防止系统宕机，建议一段时间后刷新，如下图所示：

原因分析：

系统内存不足。

解决方案：

1）等系统空闲时再进行预览。

2）通过减小数据量查看下，如通过筛选，先选一部分数据。

7.2 对象强制转换为接口类型

问题描述：

做好的 Excel 报表，点击在 Excel 中分析，报错原因：对象强制转换为接口类型......库没有注册......，如下图所示：

解决方案：

1）office 自身问题，直接安装 2019 的 office。

2）减少加载到 Excel 中的数据量，可用筛选或自助数据集提前处理。

7.3 打开仪表板直接进入编辑状态，且发布的 Excel 报表丢失

问题描述：

从 BI 仪表板打开之前的模板，直接进入到编辑状态，且在 excel 的打开按钮中找不到之前发布过的 Excel 报表，如下图所示：

原因分析：

Excel 报表的索引丢失。

解决方案：

新增接口http://ip:端口号/webroot/decision/v5/excel/plugin/recover，修复/excelModules/下 excelReportIndex.json 文件丢失导致的用户端打开窗口中无法获取 excel 仪表板以及 web 端预览历史 excel 仪表板时 url 未跳转到 view 页面显示 edit 页面的问题。BI 启动后，浏览器输入此接口可以重新读取仪表板信息恢复配置文件 excelReportIndex.json 。

再从仪表板打开 Excel 报表即可看到预览状态，如下图所示：

7.4 Excel 报表预览后显示空白

解决方案：

1）6.4.0 以下的版本（不包含 6.4.0）不支持冻结，冻结后发布空白，可取消空白或升级到 6.4.1 版本，如下图所示：

2) 6.4.0 及以上的版本，检查是否冻结和分组同时使用，不支持分组和冻结同时使用，可以取消分组后再发布，如下图所示：

3）Excel 报表 Excel 中可以算出结果，发布到 BI 显示空白：

• 数据量/计算量太大了，计算的比较慢，通常是在 Excel 中用了数据函数，计算慢

• 函数或者图表不支持，例如 Filter 函数

7.5 Excel 中显示的和发布后的样式上不一致

问题描述：

Excel 中的一些图表设置，颜色设置等，在 Excel 中显示的和发布后样式上不一致，如下图所示 ：

原因分析：

aspose 不支持。

解决方案：

本地复现后，提不适配需求。

7.6 日期字段的字段值显示成英文

问题描述：

点击预览时，日期字段的字段值显示成英文。

解决方案：

日期字段的默认格式受系统区域和日期设置的影响，需用户修改系统环境设置，或者用户端 Excel 中设置日期字段为其他的数值类型。

8.1 数据透视表预览后值没有扩展

问题描述：

数据透视表预览后值没有扩展

解决方案：

选中「数据透视表>更改数据源」，查看数据源引用路径是否是绝对路径，若为绝对路径，则需要更改 Excel 设置：

• 点击「文件-选项-信任中心-信任中心设置-个人信息选项」，取消勾选「保存时从文件属性中删除个人信息」，重新发布 Excel 报表。

• 上述方法仅更改当前模板设置，之后新建的Excel还会出现此问题。下载 EXCEL12.XLSX 将文件放入C:\Windows\SHELLNEW并替换原 EXCEl12.XLSX 文件，可更改 Excel文件全局设置。

8.2 发布后数据透视透视表的列宽自动变宽了

问题描述：

发布后数据透视表的列宽自动变了

解决方案：

点击「文件-选项-数据-编辑默认布局-数据透视表选项」，「布局和格式」中取消「更新时自动调整列宽」。