常见启动报错

（本文档仅供参考）

常见错误及原因

1.知识库连接不上

错误信息：在smartbi.log中查看到“创建知识库失败，请联系管理员”，说明作为知识库的数据库无法正常连接上

出现这种情况，就需要检查作为知识库的数据库是否可以连接上。可以从这几方面考虑

（1）检查作为知识库的数据库是否启动

（2）在smartbi服务那台电脑上，使用JDBC数据库工具或者数据库客户端工具，测试那个数据库是否能够正常连通。

（3）也有可能是用户名、密码错误等原因

2.启动连接的知识库不是空库

问题说明：搭建了一个新环境，然后设置了一个数据库作为知识库，启动的时候报出如下这些错误：

（1）

（2）

（3）

问题原因：这种情况是因为连接的知识库不是一个空库，其中已有一些知识库中相关的表，但是可能有问题。导致启动失败。建议新建一个空库，进行启动。

如果是进行升级，那么仍然建议先建立一个空库，启动成功之后。使用smartbi系统中的备份/恢复知识库进行恢复。

3.war解压异常

问题说明：日志里面有报这个错：

war可能被损坏，重新部署正常的war

4.服务器启动，闪一下就没了：用cmd输入命令启动

5.smartbi配置页面知识库保存失败

问题排查：1）检查各配置文件的存放路径以及读写权限；linux系统部署smartbi可参考文档：https://history.wiki.smartbi.com.cn/pages/viewpage.action?pageId=27000919

2）新建空库作为知识库（默认字符集为utf-8），由于您之前一直使用的是mysql中自带的mysql这个数据库，导致启动报错；
启动报错可参考文档：https://history.wiki.smartbi.com.cn/pages/viewpage.action?pageId=26445385

3）调整 MySQL 配置中允许Server接受的数据包设置值 max_allowed_packet 太小为200M
Mysql访问知识库异常Packet for query is too large可参考文档：https://history.wiki.smartbi.com.cn/pages/viewpage.action?pageId=21954739

4）linux下mysql支持ip访问的设置，可参考文档：https://wenku.baidu.com/view/393e906fbcd126fff7050bfb.html?qq-pf-to=pcqq.c2c

6.知识库编码不正确

错误信息：在smartbi.log中查看到类似乱码的日志，基本上就是编码的问题（一般是数据库插入中文乱码，解决插入中文乱码的问题即可）

说明：

作为smartbi的知识库，数据库编码必须是utf-8或者GBK。需要确保两点：

（1）作为知识库的数据库，其编码是utf-8或者GBK。创建语句如：create database test_gbk DEFAULT CHARACTER SET gbk COLLATE gbk_chinese_ci;

（2）在config界面配置知识库时，可以指定知识库的编码，这个编码必须与数据库的编码保持一致。

7.知识库表空间不足

错误现象：DB2数据库作为知识库时，启动在smartbi.log中有数据库抛出的相关错误代码。

错误代码为286，在网上搜索可知该错误号是表空间不足。

说明：

对于DB2数据库，其表空间一般有8K、16K或者32K，作为Smartbi的知识库的话，其表空间必须为32K。

采取的解决方法是：新建一个db2数据库，设置其表空间为32K。并将该库作为smartbi的知识库。相关文档：Smartbi使用DB2数据库做知识库

8.License验证失败

错误现象：在smartbi.log中发现如下错误

license验证失败

1.mac地址不匹配，这个是因为使用的是绑定IP和MAC地址的License，但是实际的应用服务器对应的IP、MAC地址与License中绑定的不一致。，可参考这个链接查看电脑mac地址：https://jingyan.baidu.com/article/380abd0a3708441d91192c56.html

2.license版本不匹配，这个日志中会有错误信息，需要重新申请对应版本的授权文件

3.license文件名有问题，需要检查文件名，是有修改。

4.License.xml文件异常。有可能是License被修改过，或者下载、上传License文件的时候，license文件损坏了。如果是修改过的话，那么要使用原来的License，如果是损坏了，那么可以重新申请License文件。