1. 概述
用户在使用设计器时会遇到设计器模板报存失败或模板无法打开等情况，但是不知道如何定位问题或者解决问题，本文根据常见的客户 bug 原因及模板保存机制，整理出了常规有关模板问题的解决方案，用户可以根据自己遇到的实际情况进行排查并解决问题。
1.1 报表文件保存机制
2. 模板创建常见问题
2.1 模板创建失败
问题描述：模板创建失败
解决方案：通常是权限的问题，可以检查远程设计权限和服务器目录权限
2.2 创建的为决策报表（frm）但生成了空白的普通报表（cpt）
问题描述：创建的为决策报表（frm）但生成了空白的普通报表（cpt）
解决方案：为新自适应插件的问题，禁用或升级插件即可
2.3 编辑模板的过程中设计器出现画面撕裂
问题描述：打开设计器添加一个决策报表后，鼠标所到之处皆为撕裂画面，无法正常使用。
原因分析：与电脑配置的显卡有关。
解决方案：
1）FineReport配置文件修改，进入设计器安装路径的bin目录下，找到 designer.vmoptions 文件，如下图所示：
2）修改文件designer.vmoptions信息：-Dsun.java2d.d3d=false，这段设置的意思是：关闭 JAVA 3D功能（Direct3D，有时候Direct3D功能可能导致JVM Crashed，默认是打开（true），属于Java Swing 2D系统属性参数。如下图所示：
3）重启设计器即可解决画面撕裂问题。
3. 模板打开常见问题
设计器当前打开模板需经过以下校验：
1）当前打开模板是否有被他人锁定。
2）当前模板结构（xml）是否正常。
若均正常，则会正常打开模板。若无法打开，排查思路如下：
1）查看日志报错：可以根据具体报错看下是不是插件的问题，可能是扩展图表插件的问题。
2）若日志中无有效信息，有可能是 xml 损坏。
注：设计器远程连接服务器设计模板的常见问题请参考：远程设计常见问题 。
3.1 打开 frm 出现空白 cpt
问题描述：打开 frm 出现空白 cpt
解决方案：新自适应插件问题，禁用或升级插件即可
3.2 预览报表无法启动浏览器
问题描述：在对报表进行分页预览，可能会遇到如下两种无法在 B/S 端展现报表的情况，无法启动浏览器，弹窗显示：
解决方案：设置电脑的默认浏览器。
3.3 设计器无法预览所有模板
问题描述：设计器点击预览无法跳转模板，新建模板也不行，报错：ERROR [standard] --job class not found, jobKey: DATA_PREPARE.DATA_PREPARE_FR-FB001
解决方案：设置更换电脑的默认浏览器或者安装预设浏览器插件
3.4 浏览器页面预览提示：无法访问此页面
问题描述：点击预览后，浏览器显示：无法访问此页面
原因分析：设计器本地预览产生该问题，多数是内置服务器启动失败导致。
解决方案：
1）确认内置服务器是否开启。绿色三角标，此时代表开启状态。若为红色方块或无此图标，则内置服务器启动失败。如下图：
2）确认是否设计器端口问题
若修改了设计器默认端口后未重启。需重启设计器即可
设计器和本地服务器的tomcat出现端口占用。可参考：端口占用查看
3）系统安装了杀毒软件或者系统防火墙阻挡，关闭杀毒软件/防火墙，重新点击预览按钮（自动启动内置服务器）即可。
4）若为设计器安装问题
若设计器安装目录为C盘，则以管理身份启动或重新安装设计器。
若设计器位数和操作系统位数不匹配，重新下载安装位数相符的设计器。
3.5 点击预览按钮，跳转到浏览器页面，模板页面空白
原因分析：
1）浏览器缓存问题，若使用IE浏览器预览空白其他浏览器正常，则有兼容问题，
2）设计器缓存文件的问题：设计器同时多次启动或非法关闭（设计器进程未关闭干净），导致用户目录下设计器缓存文件异常，模板出现预览为空白的现象。
3）模板本身问题
模板文件过大
使用了全局参数之类的服务器数据，全局参数计算异常
参数面板的控件数据字典的数据量过大，或数据字典默认值异常
有加载起始或结束事件，导致异常等
模板本身性能问题，导致模板加载动画前有一大段空白期，浏览器页面看起来像是没有反应。
4）embed的finedb里面的db.lobs被删掉了，导致读取不到二进制的内容，后台报错：com.fr.third.org.hibernate.HibernateException: IOException occurred reading a binary value，模板预览空白。
解决方案：
1）清理浏览器缓存后
检查兼容性视图：先看下是否开启了兼容性视图：（一般不要开启兼容性视图），因为兼容性模式默认的文档模式是ie5，可能模板中的一些js不支持ie5
排查插件影响：大部分问题都是插件引入的js不支持低版本的ie，或者是第三方插件没有做兼容。排查出是某个插件引起的，可以提bug
中文模板名的问题：js中有中文的模板在ie无法加载，尝试下英文名的模板能否正常加载，如果可以，则中文模板加encode编码即可
2）关闭设计器进程，清除C盘用户目录下的.fineRepot100或.fineRepot110（可以先将该文件移出去，FineReportEnv.xml中有激活码注意保留），重启设计器。
3）根据模板具体分析，修改相关设置。关掉平台-系统管理-缓存-总是重新读取模板，第一次慢，之后就好了。
4）把新的finedb里面的db.lobs替换到工程里面。
4. 模板保存常见问题
4.1 模板保存无法实时生效
问题描述：模板保存无法实时生效
解决方案：
注：集群环境需要先排查是否开启了集群缓存。
1）由于平台设置了缓存导致的，在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」，关闭后即可恢复正常。
2）若关闭「总是重新读取模板」仍无法解决，可关闭新引擎即可恢复正常。
4.2 模板保存为 0kb
问题描述：模板保存为 0kb
原因及解决方案一：工程磁盘空间不足
1）使用「磁盘清理」功能，安全便捷的清理磁盘
2）参考文档进行磁盘扩容：磁盘扩容
原因及解决方案二：
原因分析：linux中的文件索引节点inodes满了，通过df -i命令可以查inodes的使用率
解决方案：清理多余文件或者增加inodes数量
原因及解决方案三：
检查下模板文件名称是否包含 ？* 等字符，去掉特殊字符即可
4.3 模板保存失败
问题描述：模板保存失败
解决方案：
1）检查服务器 JAR 和设计器 JAR 版本是否一致，若不一致换为一致的 JAR。若版本一致，检查是否缺少 JAR，详情请参考：JAR 包异常检测
2）查看日志报错信息
报错信息为：because there was insufficient free space available after evicting expired cache entries，此为 Tomcat 环境问题，需要提高最大缓存值
报错信息为：socket write error，此问题发生在某些安装了 IPv6 TCP 堆栈的 Windows 系统上，为网络问题，添加jvm配置项-Djava.net.preferIPv4Stack=true
报错信息为：nginx 413报错，限制了请求大小（模板大小超出），修改nginx的body size配置项
报错信息为：write account error，为操作者权限不够导致文件修改保存不成功，修改文件夹权限
3）若日志无异常，可查看具体问题表现
仅某个模板保存不了：可能是 post 请求，size 大小默认限制为 2m 导致，修改 tomacat 的 post 请求大小即可
所有模板都保存不了（新建模板无法保存、旧模板也无法保存）：多数是权限问题，查看下服务器目录权限。
4.4 模板保存未生效
4.4.1 修改模板后BS浏览结果不变
问题描述：改了模板，在浏览器中访问却还是原来的结果，没有改过来。
原因分析：浏览器访问过一个页面后，会将结果缓存一段时间。修改模板后再次预览，访问路径相同，参数相同，浏览器会直接加载之前缓存的结果，导致效果没有变化。
解决方案：清空浏览器历史记录，刷新页面即可看到修改后的效果。
4.4.2 修改了模板某些设置预览时模板没有变化
解决方案：清理浏览器缓存后，检查修改内容是否进行了正确的配置，例如参数名是否和参数控件进行绑定等。
4.5 设计器异常关闭导致模板文件丢失为 temp 文件
问题描述：设计器异常关闭导致模板文件丢失为 temp 文件
解决方案：可以通过改后缀为 cpt 或 frm 恢复文件
4.6 保存模板时出现提示
问题描述：保存时出现提示：保存时发现模板锁定信息不一致，是否生成备份文件
解决方案：原因为保存时 uuid 不一致，可能是因为：
1）编辑过程中被管理员强制解锁，可参考：远程设计模板锁定
2）切换工作目录
5. 模板预览常见问题
5.1 无法正常预览
问题描述：模板无法正常预览，点击预览没反应
解决方案：
1）查看默认浏览器设置，修改下默认浏览器
2）安装插件：预设浏览器插件
5.2 预览效果与模板实际效果不一致
问题描述：预览效果与模板实际效果不一致
解决方案：由于平台设置了缓存导致的，在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」，关闭后即可恢复正常。
5.3 设计能够打开报表，但预览没有反应
问题描述：设计器能够打开报表，但是点击预览没反应，报错：cannot open the url Successful
解决方案：
1）默认浏览器设置问题（防火墙，杀毒软件），一些杀毒软件会自动改默认浏览器，绝大数情况下都是这个原因
2）远程设计，先切换到本地工作目录，可以预览报表，怀疑是jar包问题
3）url问题，直接预览配置的远程设计里的url，访问报错，发现ip地址最后多了一个空格
6. 乱码问题
为什么会出现乱码：
编码有很多种，当相互访问的两端使用不同的编码时，就可能会产生无法互相识别的情况，这是就产生了乱码。
就像一个在中国的美国人，他说的英语如果被当做汉语来解析，就是一些大家无法理解的混乱语句，比如“I love you”解析成“哎老虎油”，是无法被理解的，就产生了乱码。
设计器打开模板显示乱码的主要原因有如下几种：
1）语种显示乱码一般为缺少对应的语种字体。
2）设计器、服务器、传输工具编码不一致，导致远程设计或传输后模板打开显示乱码。
解决方法：
1）安装对应语种的语言包，并安装性能优化插件。
2）修改设计器、服务器、传输工具编码，使得三者编码一致。有的时候用户集成至自己的系统后，客户页面编码一般不能修改，即使修改了，下次如果需要变动还要修改。这时我们使用 FR 内置的 CJK 编码，就不需要考虑页面编码和服务器编码的问题了。
6.1 设计器出现泰文乱码
在设计器单元格内或者公式编辑框内编辑泰文时会乱码，如下图所示：
单元格：
公式编辑器
原因分析：设计器 OpenJDK 不支持显示泰文。
解决方案：
将 JDK 安装目录下的%JAVA_HOME%\jre文件夹拷贝，覆盖掉设计器安装目录下的%FR_HOME%\jre文件夹。
将 JDK 安装目录下的%JAVA_HOME%\jdk\lib目录下的tools.jar拷贝，复制到设计器安装目录%FR_HOME%\lib文件夹中。
注1：如果不引入 tools.jar ，设计器无法正常启动。
注2：10.0 设计器要求 JDK 版本为：JDK 1.8 且小版本需在 JDK8u102 以上。
6.2 图表中中文乱码出现方框等
原因分析：方框是缺少中文字体的缘故。
解决方案：对应计算机系统，下载更新对应的中文字体库。
6.3 泰语 韩语等小语种乱码
解决方案：修改工程所在服务器编码设置为 UTF-8
6.4 设计器界面错乱, 菜单显示成英文
原因分析：可能是上一次打开的模板里面用了当前环境里不存在的插件元素
解决方案：Ctrl + N 新建一张模板后, 退出设计器.再次启动。
6.5 设计器数据库查询界面输入乱码
问题描述
数据库查询界面的 SQL 编辑区域中所有英文都显示乱码，如下图所示：
解决方案：请参见：设计器数据库查询界面输入乱码
6.6 日文数据源预览乱码
问题描述
数据都是日语数据，数据在报表和数据库中都是正常显示的，但是用浏览器预览就是乱码
解决方案
正常显示的日文字符和不能正常显示的日文字符并非同一种字符，排查字体安装包并安装对应正确的字体包即可。
