1. java.lang.NullPointerException
1.1 问题现象
仪表板组件导出 Excel 后，打开 Excel 报错：errorCode:500, errorMsg: java.lang.NullPointerException，如下图所示：
查看 FineBI 日志%FineBI%/logs/fanruan.log，对应的报错如下：
java.lang.NullPointerException
at sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1264)
at sun.awt.FontConfiguration.readFontConfigFile(FontConfiguration.java:219)
at sun.awt.FontConfiguration.init(FontConfiguration.java:107)
at sun.awt.X11FontManager.createFontConfiguration(X11FontManager.java:774)
at sun.font.SunFontManager$2.run(SunFontManager.java:431)
at java.security.AccessController.doPrivileged(Native Method)
at sun.font.SunFontManager.<init>(SunFontManager.java:376)
at sun.awt.FcFontManager.<init>(FcFontManager.java:35)
at sun.awt.X11FontManager.<init>(X11FontManager.java:57)
at sun.reflect.GeneratedConstructorAccessor654.newInstance(Unknown Source)
at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
at java.lang.reflect.Constructor.newInstance(Constructor.java:423)
at java.lang.Class.newInstance(Class.java:442)
at sun.font.FontManagerFactory$1.run(FontManagerFactory.java:83)
at java.security.AccessController.doPrivileged(Native Method)
at sun.font.FontManagerFactory.getInstance(FontManagerFactory.java:74)
at java.awt.Font.getFont2D(Font.java:491)
at java.awt.Font.canDisplayUpTo(Font.java:2060)
at java.awt.font.TextLayout.singleFont(TextLayout.java:470)
at java.awt.font.TextLayout.<init>(TextLayout.java:531)
at com.fr.third.v2.org.apache.poi.ss.util.SheetUtil.getDefaultCharWidth(SheetUtil.java:254)
1.2 原因分析
该报错是由于 Linux 系统没有相关 font 资源导致，需要为系统安装字体管理器。
1.3 解决方案
在 Linux 中执行如下命令安装字体管理：
yum install fontconfig
如果使用 docker 制作基础镜像运行以下命令：
RUN yum -y install fontconfig RUN fc-cache --forc
2. java.lang.IllegalArgumentException:The workbook already contains a sheet of this name
2.1 问题现象
导出 Excel，打开 Excel 报错如下：
2.2 原因分析
Excel中 sheet 命名有如下规则：
1）sheet 名称不能多于31个（包含英文、汉字、| 、（）等，但是不能包含： 、/、？、*、[]等 )，程序中使用 poi 工具来生成的时候，传进去大于 31 个长度的字符串时，会被自动截取，便会导致两个名字变为一样的，出现sheet同名异常
2）sheet 名字不能为空，为空也会报错。
2.3 解决方案
修改组件名称以及对应的长度，使其符合excel命名规则。
3. Could not initialize class sun.awt.X11GraphicsEnvironment
3.1 问题现象
Linux 环境下导出 Excel 失败，查看日志或按 F12 进入控制台，出现报错：Could not initialize class sun.awt.X11GraphicsEnvironment
3.2 原因分析
在Linux下，仪表板导出 Excel 时，会用到 Java 的图片包来处理图片。而 Java 虚拟机在处理图片时需要本地的 x-server 支持，若是没有就会出现该报错。
3.3 解决方法
3.3.1 直接安装的 FineBI
在路径 %FineBI5.1%\bin 下找到finebi.vmoption文件，在文件内新增-Djava.awt.headless=true，保存文件。如下图所示：
3.3.2 部署到 Tomcat 的 FineBI
进入%Tomcat%/bin目录，找到并编辑配置文件catalina.sh，增加-Djava.awt.headless=true参数，详情请参见：导出 Excel 设置。
4. com.finebi.common.exception.execute.FineOutOfMaxRowException: out of row restriction: xxxxxxx
4.1 问题现象
导出 Excel，打开 Excel 报错如下：
4.2 原因分析
导出的 Excel 数据量超过数据量限制。
4.3 解决方案
通过筛选等方式减少导出数据量。
5. 数据量超过限制：Export Column Out Of Limit!
5.1 问题现象
仪表板导出 Excel 时报错数据量超过限制：超过100列无法导出，请联系管理员，如下图所示：
5.2 原因分析
导出列数超过100列。
5.3 解决方法
在外接数据库中修改参数，输入：insert into fine_conf_entity(id,`value`) values ('SystemOptimizationConfig.crossExportColumnLimit','数值')，不建议将数值修改很大。
