设计器模板常见问题- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：Catqiu

编辑次数：4次

最近更新：Catqiu 于 2022-05-30

1. 概述

用户在使用设计器时会遇到设计器模板报存失败或模板无法打开等情况，但是不知道如何定位问题或者解决问题，本文根据常见的客户 bug 原因及模板保存机制，整理出了常规有关模板问题的解决方案，用户可以根据自己遇到的实际情况进行排查并解决问题。

1.1 报表文件保存机制

2. 常见问题及解决方案

2.1 模板创建常见问题

错误详情	解决方案
模板创建失败	通常是权限的问题，可以检查远程设计权限和服务器目录权限
创建的为决策报表（frm）但生成了空白的普通报表（cpt）	为新自适应插件的问题，禁用或升级插件即可

2.2 模板打开常见问题

设计器当前打开模板需经过以下校验：

1）当前打开模板是否有被他人锁定。

2）当前模板结构（xml）是否正常。

若均正常，则会正常打开模板。若无法打开，排查思路如下：

1）查看日志报错：可以根据具体报错看下是不是插件的问题，可能是扩展图表插件的问题。

2）若日志中无有效信息，有可能是 xml 损坏。

错误详情	解决方案
打开 frm 出现空白 cpt	新自适应插件问题，禁用或升级插件即可

2.3 模板保存常见问题

错误详情	解决方案
模板保存无法实时生效	注：集群环境需要先排查是否开启了集群缓存。 1）由于平台设置了缓存导致的，在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」，关闭后即可恢复正常。 2）若关闭「总是重新读取模板」仍无法解决，可关闭新引擎即可恢复正常。
模板保存为 0kb	这是由于磁盘空间不足导致的，在11.0.2及以上的版本和10.0.19及以上的版本都已修复。在保存模板时，若发现磁盘空间不足，则会弹出警告框，提示用户清理磁盘空间后再保存。 1）如果用户环境低于11.0.2或低于10.0.19，且发生了模板丢失的现象，如何找回？若为集群环境：找之前的备份还原了，没有备份就只能重做若非集群环境：查看用户是否使用了版本管理功能，通过版本管理还原即可。若无可以通过 git 还原。 2）特殊情况：磁盘还有空间，但仍报错空间不足检查下模板文件名称是否包含？* 等字符，去掉特殊字符即可
模板保存失败	1）检查服务器 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配置项即可报错信息为：nginx 413报错，限制了请求大小（模板大小超出），修改配置项即可 3）若日志无异常，可查看具体问题表现仅某个模板保存不了：可能是 post 请求，size 大小默认限制为 2m 导致，修改 tomacat 的 post 请求大小即可所有模板都保存不了（新建模板无法保存、旧模板也无法保存）：多数是权限问题，查看下服务器目录权限。
设计器异常关闭导致模板文件丢失为 temp 文件	可以通过改后缀为 cpt 或 frm 恢复文件
保存时出现提示：保存时发现模板锁定信息不一致，是否生成备份文件	原因为保存时 uuid 不一致，可能是因为： 1）编辑过程中被管理员强制解锁，可参考：远程设计模板锁定 2）切换工作目录

2.4 模板预览常见问题

错误详情	解决方案
模板无法正常预览，点击预览没反应	1）查看默认浏览器设置，修改下默认浏览器 2）安装插件：预设浏览器插件
预览效果与模板实际效果不一致	由于平台设置了缓存导致的，在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」，关闭后即可恢复正常
设计器能够打开报表，但是点击预览没反应，报错：cannot open the url Successful	1）默认浏览器设置问题（防火墙，杀毒软件），一些杀毒软件会自动改默认浏览器，绝大数情况下都是这个原因 2）远程设计，先切换到本地工作目录，可以预览报表，怀疑是jar包问题 3）url问题，直接预览配置的远程设计里的url，访问报错，发现ip地址最后多了一个空格

错误详情

解决方案

模板无法正常预览，点击预览没反应

1）查看默认浏览器设置，修改下默认浏览器

2）安装插件：预设浏览器插件

预览效果与模板实际效果不一致

由于平台设置了缓存导致的，在「管理系统>抽数缓存>缓存配置」开启了「总是重新读取模板」，关闭后即可恢复正常

设计器能够打开报表，但是点击预览没反应，报错：cannot open the url Successful

1）默认浏览器设置问题（防火墙，杀毒软件），一些杀毒软件会自动改默认浏览器，绝大数情况下都是这个原因

2）远程设计，先切换到本地工作目录，可以预览报表，怀疑是jar包问题

3）url问题，直接预览配置的远程设计里的url，访问报错，发现ip地址最后多了一个空格