1. 功能问题

1.1. 静态化未达预期效果排查方式

· 优先本地启动项目，线上环境复杂，如果已经发布还容易破坏生产环境；确保数据是一致的，代码没有差异。

· 本地启动后如果并未复现问题，可能是线上环境问题，例如服务器没有文件写入权限导致静态化文件未生成或者文件访问权限不足等。

· 本地问题与线上一致，就需要排查是数据问题还是模板问题，排查技巧为：先清空html静态文件夹，逐个栏目生成来定位是哪个栏目出现的问题。

· 定位到某个栏目后，可以先逐渐删除模板内容，减少日志生成，通过日志中的sql执行和log信息结合来判断问题原因。

· 其中数据问题一般是由非法直接导入数据产生，这类问题占比较少，通常是因为缺少必要关键字段如文章更新时间等导致的静态化失败。

· 模板问题种类繁多，占比量很高，常见原因有：模板代码有语法问题；模板丢失；错误绑定了一个不存在的模板等等。

[!tip] 比较棘手的问题一般都是由于环境等第三方问题导致，需要开发者结合日志冷静分析。

1.2. 百度编辑器上传大小怎么设置？

[!tip]如果想要控制文件上传大小等操作可以修改该配置文件以及在页面中的初始化参数。现在官方已经不再维护百度编辑器，推荐使用store的新版编辑器。

1.3. 上传模版失败？

可能由于上传文件过大导致，修改application.yml文件

1.4. 系统默认的文章数据发布时间为什么是未来时间？

因为这些只是演示数据，这么做是为了解决生产文章是可以直接默认当前是时间直接生成即可。

1.5. 生成主页按钮显示不出来

是由于你当前没有这个权限，需要去重新分配权限。（直接导入最新的数据库，默认账号就有权限）

1.6. 登录后台之后为什么好多页面都是404或者500

如果你代码是最新的，那应该是你数据库导入错了，直接导入最新版本的数据就可以了

1.7. 启用移动端用手机访问为什么是空白页面

先确认你的模板中是否有手机端，如果有手机端开启了访问移动端的用手机访问就是访问移动端的模板，如果没有模板手机端访问的则是空白的，这个时候建议把启用手机端的按钮去掉勾选

1.8. 怎么没有生成器菜单

系统更新把生成器功能集合成静态化了，在内容管理菜单下面

1.9. 为什么主页、栏目、文章都生成了，访问文章还是404

生成文章的时候需要注意生成的时间需要往前推

1.10. 在后台文章上传图片成功之后会显示，但是过一段时间就会裂开

因为图片是上传到Tomcat中，每当重置的时候图片就会消失，建议你上传完图片进行备份一下，或者上传完图片把upload文件夹覆盖项目中的这个文件夹

1.11. 首页（前端）界面样式混乱或无法打开

登录后台找到静态化菜单进入，进行所有的生成操作就能修复。

1.12. 文章访问不了或没有生成成功

需要在生成文章时，选择生成文章时间，起始时间要选择靠前一点，比如文章时在2015年08月1日创建的，那么生成的时候时间需要选择在2015年08月1日前。

1.13. 栏目页面有部分乱码，如下截图

需要更改tomcat/conf/server.xml文件的Connector节点(端口配置的Connector节点)增加URIEncoding="UTF-8"，

1.14. 生成栏目，生成文章点击更新，一直出于更新中

标签使用错误所以才会出现这种情况，仔细检查一下写的标签

1.15. 生成主页时，选择主页模板出现“暂无文件”

去系统设置--->应用设置里面重新保存一下，再去刷新一下生成主页界面即可。

1.16. 当系统中“文章管理”与“静态化”出现404的情况，其他功能正常

这个可能是由于后台代码没有编译到，需要重新去编译成功，再启动（编译之后同步到tomcat，建议先去tomcat里面看下一是否同步成功）

1.17. 静态化报错

静态化时出现报错，日志或页面显示报错信息为 ${field.data?string("yyyy-MM-dd")} 标签语法错误，如下图

1.表content_datetime字段需为timestamp类型，且该字段值不能为空，出现上图报错排查数据库数据是否合规

2.企业版、政务版用户优先排查缓存管理中是否正确缓存了文章需要在系统设置---->缓存管理里进行刷新缓存，然后重新静态化即可。

[!tip] 文章缓存是缓存在如ehcache或Redis（企业版不支持）中，并非缓存至本地，各个管理员账号缓存数据共通。

1.18. 添加二次开发的业务，配置免登录放行

需要在Action中的RequestMapping中，去掉${ms.manager.path}，例图

1.19. 访问网站域名和访问主页地址页面展示不一致

生成了default.html，通过域名访问网站时，默认访问default.html，没有才访问index.html；预览主页默认是访问index.html

1.20. 不符合xss规则

在yml，ms.xss-exclude-url中添加异常信息提示的接口不符合xss规则的请求或ms.xss-exclude-filed中添加添加异常信息提示的参数名

1.21. 模板样式失效

1、参考global.style标签的使用，确保按照文档描述使用； 2、更新标签或在浏览器控制台查看静态资源引用地址，补全缺失的目录或"/" 3、如果配置了项目名，需要加上global.contextPath标签，具体参考global标签文档

功能问题