（本文档仅供参考）

常见错误及原因

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。

（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文件。

5.确认授权文件没问题，之后启动还是报错，可能是缓存问题，更换license之后需要清一下缓存

9.tomcat启动不正常

错误现象：tomcat启动完成后访问不正常，报错：This is very likely to create a memory leak.

此问题看不出原因，具体错误都需要从tomcat自带日志分析，拿回整个文件夹日志。

10.读写权限问题

错误现象：在smartbi.log中，会抛出如下错误日志

这种错误一般是因为当时启动服务器的操作系统用户，对于对应的文件没有相应的权限导致的。

如果是Windows系统，使用“以管理员账号”启动服务。

如果是Linux系统，需要对用户设置对应文件的权限。

11.MySQL Packet for query is too large

错误现象：在smartbi.log或者控制台看到如下错误信息

这种错误是因为MYSQL 中配置中允许Server接受的数据包设置值max_allowed_packet 太小所导致的。可以参考文档：MySQL知识库访问异常Packet for query is too large 解决。

12.端口被占用

错误现象：在日志中有如下信息：Address already in use <null>:8009 或者 ava.lang.Exception: Socket bind failed: [730048]

        对应端口的被其他进程占用