1. 概述编辑
本文主要介绍了文件数据集在使用中经常出现的问题以及解决方案。
1.1 排查思路
文件数据集在遇到问题时的常见排查思路如下图所示：
2. 排查步骤编辑
2.1 文件上传读取异常
「数据决策系统>服务器数据集」中，可以将客户端本地的文件上传到服务器的 reportlets/excel、reportlets/xml、reportlets/txt 文件夹下。
1）服务器网络上传受限：网络问题会影响客户端文件上传到服务器，常见的是nginx上传文件大小的限制，需要调整 nginx.conf 文件配置。
2）文件夹没有读写权限
如果服务器文件夹没有读写权限，文件会上传失败，这时需要给服务器文件夹赋读写权限。
2.2 取数失败
1）文件加密
文件数据集如果进行了加密处理，FineReport 将无法加载数据从而导致预览空白，同时日志会报错：Package should contain a content type part [M1.13]。需要用户手动给文件进行解密处理。
2）数据量或文件体积过大触发限制
产品目前支持的文件数据集体积最大为 20M，若文件超过 20M将无法取数。
在「智能运维>内存管理>模板限制」中的导入 Excel 单元格限制设置会对文件数据集生效。这类原因导致取数失败，需要在数据决策平台中调整导入 Excel 单元格限制即可解决问题。
3）远程数据集网络不通
4）远程数据集 URL 地址类型不支持
FineReport 支持的是浏览器访问就能自动下载的或者直接预览内容的URL地址。如果文件数据集的URL地址用浏览器访问并不会直接下载，而是需要点击操作，这类 URL 地址是不支持的。此外，远程数据集地址不支持使用 ftp 协议或者谷歌云盘文件。
5）远程数据集 URL 地址或参数中包含中文，需要手动转码后再使用。
6）XML 数据不规范。
7）远程设计时 JAR 版本不一致也会导致取数失败，将服务器和设计器 JAR 版本统一即可解决问题。
8）远程设计时报表服务器没有启动好也会出现新建文件数据集选择 Excel 文件不能正常预览的情况，此时重启服务器即可。
2.3 取数缓慢
网络问题导致的取数缓慢，可以优化网络或将文件放到服务器磁盘上离线使用。
2.4 设计器取数与预期不符
1）服务器数据集中文件数据集不支持使用动态时间或公式作为参数。
2）目前 Finereport 的 Excel 数据集只能取到第一个 sheet。
3）设计器默认根据 Excel 第一行数据的格式，对整列数据进行标记处理，需要统一数据格式。
2.5 页面数据展示错误
1）当 Excel 里面字段的标题里面有多余空格时，字段在数据集中预览正常，拖入单元格后预览模板，该字段则不显示，需要用户只能手动处理删除多余空格。
2）Excel 的 HH:mm:ss 格式的时间类型数据不支持识别，会默认格式化成字符串。如果 Excel 中设置的格式日期控件能识别，就保留格式，否则转换为 yyyy-MM-dd HH:mm:ss 格式。
3）甘特图数据设置为无，不会去读取文件数据集中表头空白的列数据，此时将 JAR 包更新至 10.0.19.7 及之后版本即可