1. 配置问题
1.1. 修改config配置未生效
config配置以mcms下的配置为标准,它会覆盖其他配置导致出现修改配置没有生效的问题。
1.2. 修改ms.manager.path和ms.manager.login-path问题
- 修改ms.manager.path 不能修改为cms、mcms等和web层接口重名冲突的名称
- 修改login-path 需要有一个登录地址和配置的login-path对应上
1.3. sql注入问题
1.3.1. 开源版本
先更新到最新版本,删除排除路径中有关/ms/,/此类路径,也可以单独设置排除路径
1.3.2. 政务版本
启用xss过滤器,并删除排除路径中有关/ms/**
,/**
此类路径,也可以单独设置排除路径
[!tip] 由于自定义会有动态修改表的操作和关键字,如果上线后仍需要使用自定义相关功能,建议加上/ms/mdiy/**的配置
1.4. 启动报java.nio.charset.MalformedInputException: Input length = 2
产生原因:中文字符导致
快速解决方法,将yml中的中文注释全部删除
规范:禁止使用文本编辑器来修改配置文件,避免导致编码问题;推荐在ide中修改好
1.5. 浏览器缓存导致看不到最新页面
- 查看页面效果时按住shift刷新页面
- 开发时,可选择设置浏览器,禁用浏览器缓存
- 在模板中设置,通过html的meta属性设置不要缓存;参考博文
[!tip] 说明:缓存是浏览器的功能特性,不是系统Bug
1.6. 定时调度任务执行失败
通常是由于任务没有正确配置参数导致的,例如生成首页,
调用目标:generaterServiceJob.index('index.htm','index.html','outsite','http://localhost/')
这里第一个参数'index.htm'指的是对应模板文件;
第二个参数'index.html'指的是主页文件名;
第三个参数'outsite'指的是自定义字典中设置模板类型数据值;
最后一个参数'http://localhost/'指的是调用本机。
需注意第三个参数填写正确,选择正确的模板类型。
1.7. 站群插件未生效
站群的依赖需要放到pom文件中依赖的第一位,因为站群插件重写了basic, 不放在第一位可能会导致站群不生效的情况。
1.8. 浏览器图标添加
<!--以默认模板为例,在head-file中添加下面引用,重新静态化-->
<link rel="shortcut icon" href="图标路径">
1.9. tinymce编辑器插入地图提示APP被禁用
访问百度地图控制台,注册获取ak
在static/plugins/tinymce/5.10.2/plugins/bdmap/bd.html和map.html中,使用获取到的ak
...
<!-- 更换成您的ak -->
<script charset="utf-8" src="https://api.map.baidu.com/api?v=3.0&ak=您的ak"></script>
...
1.10. 更换域名后页面仍然显示ip地址
页面标签 {ms:global.url/}、{ms:global.host/}是从 APP 表中取地址字段进行渲染。
第一步:确认当前用域名登录后台,然后只需要在应用设置里保存一下,不需要做任何操作就可以更新地址字段。
第二步:确认 APP 表中地址字段修改成域名,然后重新静态化。
第三步:确保静态化操作没问题,刷新页面就可以了(没效果强刷下页面)。
[!tip] 简单调试办法,首页模板只留{ms:global.url/}、{ms:global.host/},查看输出结果是否正确。 注意:若出现文章点击数失效的问题,在缓存管理里刷新缓存重新静态化即可。
1.11. 复制富文本图文,更换上下文后导致图片不显示问题
第一步:通过编辑器的查看源代码功能,确定当前内容中图片路径是(上下文)/upload格式,否则说明图片没有上传成功。
第二步:由于图片链接是作为文本数据存在数据库中的,由于更换了上下文,导致原来的存储的图片路径在新的上下文中链接失效。可以写个脚本把数据库中新、旧上下文进行replace
1.12. 需要让标签生成域名解析为https
代理应用时标签解析域名依旧为http时,首先需要确认yml配置中 ms.scheme为https,然后应用设置保存、刷新缓存即可。
1.13. 加项目名后预览页面404,页面路径缺少项目名
出现这种情况可能是用户部署在Tomcat上加了项目名,没有在yml文件里配置,需要在yml里也进行配置, 并确保和Tomcat上项目名一致。
1.14. idea使用Tomcat开发,上传模板重启后模板消失
因为是上传到Tomcat内置的环境,重启Tomcat默认清理所有文件导致文件消失,解决方案:
1.开发过程中模板直接放在项目中,不要通过上传的方式放进去
2.上传的模板可以在重启之前,从Tomcat里面复制出来到项目中
1.15. 路径层级太深问题
可以通过MStore短链接插件或nginx代理解决
1.16. 超过1分钟,显示数据库链接超时
修改yml中spring.datasource.druid.maxWait的配置
1.17. 上传图片一直在加载
将yml中ms.upload.enable-web设置为true
1.18. mce编辑器上传超时
1.19. 内网一个服务器搭建站群(多站点)
1、通过花生壳之类的工具,做内网穿透,再泛解析一个域名到服务器; 2、通过nginx代理,转发各个端口到系统的服务器
1.20. pom文件报某些jar包缺失
建议多强制更新几次,最好是先删除本地之前下载的jar,然后重新maven强制更新
1.21. 启动时报缺少某个类,创建bean对象失败
可能是没有编译到,先重新clean、compile试一下,还是不行的话那就清除下idea缓存再maven强制更新一下
1.22. maven update强制更新一直下载不了报,一直报jar报缺少
是不是改了maven仓库的地址。是不需要修改的,直接使用默认的就行。
1.23. mysql8.0驱动报错
需要使用jdk8 以上版本
1.24. 包有错误且中文是乱码
项目右键属性窗口,配置项目编码格式为UTF-8
1.25. idea Tomcat 配置
1.26. 启动es依赖报错
解决方法
- 删除在该仓库下的org.elasticsearch文件夹
- maven配置中央仓库拉取依赖(不能使用阿里云镜像,尽量使用国外的)
- 重新拉取依赖,在仓库中找到es相关依赖并且版本对应
- idea中刷新一下maven
1.27. 启动报错
1.27.1. 情况1 第一次启动报错
解决办法
- 删除在该仓库下的net.mingsoft文件夹
- maven配置中央仓库,重新拉取依赖(不能使用阿里云镜像!)
1.27.2. 情况2 jar启动报错
1.首先看本地ide启动是否正常,本地不正常请参考情况1 2.把config文件中的配置与ide中resource文件夹下的同步