部署运行常见问题

遇到问题，请先检查下面的常见问题。如果找不到，也请先百度，做下功课，然后开个issue提问：这里

避免无效沟通，珍惜生命！！

1. ES身份认证失败

原因：

ElasticSearch登录身份认证失败

解决方案：

1、取消ES身份认证
2、配置文件打开ES身份认证标志，并配置账号密码，如图：

2. 文件上传失败：too large

原因：

文件大小超过设定的限制

解决方案：

要修改上传文件体积限制：
1、nginx.conf，修改htpp节点下的（如没有此项则增加）：
client_max_body_size 2000m;
2、application-prod.yml文件修改：
spring:
servlet:
multipart:
max-file-size: 2000MB
max-request-size: 2000MB

3.首次检索失败

原因：

索引不存在

解决方案：

首次上传文件后，系统会自动建立索引，然后才可以检索。此前的检索会找不到索引。

4.登录页面验证码不显示，报错404

原因：

无法正常访问后端接口服务

解决方案：

1、先确保后端服务启动成功，后台日志出现如下输出：
`———————————————————-
Application KYKMS is running! Access URLs:
Local: http://localhost:8080/ky/
External: http://xxx.xxx.xxx.xxx:8080/ky/
2、确保nginx配置文件配置正确，默认使用代理方式访问后端接口，请检查proxy配置。或者改为直接访问后端接口，方法：在nginx的部署路径下（默认为html），找到config.js，修改如下配置项：
API_BASE_URL: ‘http://后端服务器IP:8080/ky’,
直接访问的方式，请确保后台服务器的8080端口能正常访问.
3、如果均未能解决，请在浏览器按下f12找到报错404的网络访问，把获取验证码的接口地址拷贝出来，换个后端ip直接访问看看什么报错：
http://serverIp:8080/ky/sys/randomImage/xxxxxxxx
开个issue提问：这里

5.后台报错xxx表不存在

java.sql.SQLSyntaxErrorException: Table ‘km.KM_DOC_BUSINESS_TYPE’ doesn’t exist

原因：

表不存在或者mysql大小写敏感

解决方案：

1、如果表不存在，则建表，或采用初始化sql脚本重新初始化数据库
2、如果表存在，在可能是mysql大小写敏感的原因，参考如下办法调整：大小写敏感

6.预览文件乱码

原因：

在linux环境运行，缺少中文字体

解决方案：

1、可以从windows目录获取simsun.ttc字体，拷贝到/usr/share/fonts下。
2、或者下载

7.打包后，无法启动jar包，报错java,lang,NoClassDefFoundError

原因：

Jar包打包方式为lib分离的方式

解决方案：

参考此处调整：JAR分离打包部署

8.上传附件的大小有限制吗

开源版默认上传附件大小限制为2M，其他版本也有限制，请问是否可以调整？

原因：

按需调整，限制可自行设定。开源版自行调整配置文件，其他版本在部署的时候也可以按需调整。
理论上，附件大小是可以无限大，但实际上，为了避免过大附件上传发生的异常，以及节省空间，一般需要设定一个限制。
如果需要上传较大附件，可以设置为100M或者1G或更大。

解决方案：

设置方法参考第二条：文件上传失败：too large

9.自定义的logo和横图图大小尺寸怎么确定

自定义的logo和横图图大小尺寸怎么确定？

答：

Logo尺寸比例为30X30或其他1:1的小图片，横图比例为50X260。