1. 概述
本文主要汇总了 FineReport 10.0 升级至 11.0 后部署集成常见问题及解决方案，便于大家更好的解决升级过程中遇到的问题。
2. 部署启动
2.1 部署启动报错404
问题描述：
1）升级之后系统访问报错404。
2）服务器启动报错404。
3）升级后通过IP访问决策系统报错404。
原因分析：
1）可能是升级后的 JAR 包与插件冲突。
2）服务器启动下的 JAR 包存在多余的 JAR 包。
3）server.xml 配置文件的 IP 填写错误。
解决方案：
1）排查是否 JAR 包与插件存在冲突，若是，则将插件禁用即可，或删除对应的插件相关文件。
2）排查 \WEB-INF\lib 下面 是否存在多余的 JAR 包，若是，则删除多余的 JAR 包即可。
3）server.xml 配置文件的 IP 修改为对应 IP 地址，重启即可。
2.2 登录系统报错：Decision inject render to html tag fail
问题描述：
自启动的 tomcat 登录系统报错“Decision inject render to html tag fail”，bat启动登录正常。
原因分析：
tomcat 内存太小无法启动工程。
解决方案：
在注册表编辑器中，修改 JvmMs（初始化内存）和 JvmMx（最大内存）为 8192M 即可。
2.3 升级后启动 tomcat 一直访问的是原先10的环境
问题描述：
对备份tomcat操作了工程升级后，启动tomcat，访问的还是原先的10的平台。
原因分析：
环境变量配置了CATALINA_BASE和CATALINA_PATH，导致每次启动都是启动的参数配置的tomcat，如图：
解决方案：
方案一：确保环境安装了 jdk 的情况下，删除 catalina 环境变量的配置，重启 tomcat。
方案二：将升级成功的 webroot 复制到上述 catalina 参数指定的 tomcat 中启动。
2.4 tomcat运行抛错，不影响正常使用
问题描述：
10-11后，后台日志一直抛错“ERROR java.lang.ArrayIndexOutOfBoundsException”
报错关键字：java.lang.NullPointerException: null com.fr.decision.webservice.filter.PluginStoreFilter.doFilterInternal(Unknown Source) [fine-decision-11.0.jar:?]
原因分析：
工程加载了一些不存在的文件，导致了该异常
解决方案：
升级到 11.0-2022-05-07 版本的 jar 即可
3. 单点登录
3.1 升级后单点登录失败
原因分析：
谷歌的默认 SameSite 策略不允许 cookie 跨站发送导致单点失败。
解决方案：
更新到 11.0.4 及之后版本，并配置https协议解决，可参考：谷歌浏览器单点登录失败。
3.2 升级后前端单点登录失败
问题详情：
FineReport 9.0 版本与其他产品集成，升级后 11.0 版本后单点登录失败。
原因分析：
升级后接口变更导致单点登录失败。
解决方案：
重新安装单点登录插件，重新配置单点登录地址即可。
3.3 普通用户登录报错:Decision inject render to html tag fail
原因分析：
FineDB 中存在脏数据。
解决方案：
FineDB 中存在脏数据，您可以前往「服务平台」，选择「在线支持」联系技术支持寻求解决方案。
3.4 升级后通过集成的系统预览模板，模板预览空白
问题描述：
升级前正常已将 FineReport 集成到自己系统，升级前预览模板正常，升级之后异常，模板预览显示空白。如下图所示：
原因分析：
升级前单点登录接口实现的单点效果，升级后单点登录的接口变更导致模板预览失败。
解决方案：
更换 11.0 版本前台单点接口配置，重新配置即可。可参考：前台单点登录接口
3.5 升级后OA前端单点登录失败，同步的用户登录决策系统无法登录
原因分析：
9.0 版本 FineReport 内置的 MD5 加密方式不区分密文大小写。
10.0 版本 FineReport适配的 MD5 加密方式区分大小写。
11.0 版本 FineReport适配的 MD5 加密方式区分大小写。
9.0 同步选择内置 MD5 加密，升级后会内置一个小写 MD5 的 class，如果是大写密文，升级后就不能登录，需要手动替换大写 class。
解决方案：
替换方法可参考：同步用户密码加密设置，class 文件点击下载：MD5UpperCasePasswordValidator.zip
3.6 10-11升级后钉钉应用报错：corpId不合法
问题描述：
升级之前，钉钉应用正常，升级后，钉钉应用无法正常使用，钉钉插件和jar均是11.0-2022-05-07最新jar对应的最新版本，报错如下：
原因分析：
10-11升级后，钉钉应用地址不兼容。
解决方案：
1）重新生成钉钉应用地址，同步到钉钉应用
2）再保存钉钉应用，重新发布，如下图
