基于 Java 的开源企业级网站内容管理系统（Java CMS）新一代企业级 CMS 系统，支持信创、等保合规，专注安全

源码资源网 · 发表于昨天 09:54

基于 Java 的开源企业级网站内容管理系统（Java CMS）新一代企业级 CMS 系统，支持信创、等保合规，专注安全
使用SpringBoot、MyBatis、Vue3、ElementPlus、Vite、TypeScript等技术开发。支持无头CMS，支持自定义字段及字段可视化设计。可免费用于商业网站。
一款基于 Java 的开源企业级网站内容管理系统（Java CMS），采用 SpringBoot、MyBatis、Spring Security、Vue3、Vite、ElementPlus 等前沿技术开发，支持无头 CMS 架构。系统提供模板 + 标签和 Vue (React) + API 两种开发模式，适用于传统模板渲染和现代化前后端分离场景，为网站的建设、管理与维护提供高效、灵活、可靠的解决方案。
环境要求

JDK 11 或 JDK17
MySQL 8.0 (5.7.22+)
Tomcat 9.0 (Servlet 3.1+)
Maven 3.6.3+

后端技术

Spring Boot：提供了对 Spring 开箱即用的功能。
Spring MVC：MVC 框架。
Spring Security：安全组件。
MyBatis：持久化框架。
Lucene：全文检索组件。
Flowable: 工作流引擎。
Liquibase: 数据库表结构版本管理组件。
Freemarker: 模板引擎。

前端技术

Vue3：JavaScript 框架。
ElementPlus：Vue 3 UI 框架。
Vite: 下一代前端开发与构建工具。
TypeScript: JavaScript 的一个超集。
Tailwind CSS: 功能类优先的 CSS 框架。
Pinia: Vue 状态管理库。
VueRouter: Vue 路由组件。
VueI18n: Vue 国际化组件。
ECharts: 可视化图表库。
Tinymce: 富文本编辑器。

创建数据库

创建数据库。数据库名可为或其它任何名称。MySQL 字符集选 utf8mb4（不要使用 utf8 ，该字符集可能导致某些特殊字符出现乱码）
无需执行 SQL 文件，程序启动时会自动创建表及初始化数据。以后程序升级同样不需要执行 SQL 升级脚本，程序启动时会判断当前软件版本及数据库表结构版本，自动进行数据库表结构升级

启动程序

注意：不要将程序放在有中文或空格的路径下。

打开项目。在 IntelliJ IDEA 中点击 File - Open，选择项目文件夹（有 pom.xml 的文件夹）。会开始从 maven 服务器下载第三方 jar 包（如 spring 等），需要一定时间，请耐心等待。

连接数据库。打开 /src/main/resources/application.yaml 文件，根据实际情况修改以下配置：

spring.datasource.url：数据库连接地址
spring.datasource.username：数据库用户名
spring.datasource.password：数据库密码

启动程序。可在左侧 Project 导航中找到 /src/main/java/com//cms/Application 类，右键点击，选择 Run 'Application'。也可直接点击右上角的绿色三角图标 (Run 'Application')。

如程序无法正常编译，通常是因为 maven 没有正确下载 jar 依赖包。可以尝试在 IntelliJ IDEA 的 Maven 窗口点击刷新按钮 Reload All Maven Projects 按钮，尝试重新下载 jar 依赖包，或者点击菜单 Build - Rebuild Project 重新编译项目。

如首次使用 IntelliJ IDEA，没有配置 JDK，也会导致无法正常程序不能编译。可选中项目，点击 File - Project Structure...，在 Project Settings - Project 处，配置 Project SDK。

确认启动

确认启动完成。首次运行程序，系统会自动创建数据库表和初始化数据库，需要一些时间，请耐心等待。直到出现类似 com..cms.Application: Started Application in xxx seconds 信息，代表程序启动完成。

常见错误

程序启动时出现 LockException: Could not acquire change log lock 或 Waiting for changelog lock... 错误信息。解决办法：将数据库 databasechangeloglock 和 flw_ev_databasechangeloglock 表中数据清空（请注意，不是 databasechangelog 和 flw_ev_databasechangelog 表），或者删除数据库所有表（也可重建数据库），再次启动程序即可。原因：程序启动时会自动创建、升级数据库表结构，如果此时强行关闭程序，再次启动可能会出现这个问题。

程序启动时出现 Specified key was too long; max key length is 767 bytes 错误信息。解决办法：设置 MySQL 参数 innodb_large_prefix=ON。原因：从 MySQL 5.7.7 开始，innodb_large_prefix 参数默认已设置为 ON，但第三方面板或云服务商提供的 MySQL 可能修改默认配置。

程序启动时出现 java.io.IOException: Problem reading font data 错误信息。解决办法：安装 FontConfig 组件，执行 yum install -y fontconfig（CentOS 系列）或 apt-get install -y fontconfig（Ubuntu 系列）。原因：系统没有安装字体组件，导致验证码生成组件无法读取字体。

访问程序

前台地址：http://localhost:8080/，使用手机访问前台或者使用浏览器模拟手机访问前台，会自适应显示手机端的界面。如遇到前台页面没有样式的情况，则是因为没有部署在 Tomcat 的根目录。如前台首页地址类似为 http://localhost:8080/abc ，即代表部署在 /abc 目录下，没有部署在根目录。解决办法请参考下面关于部署路径部分内容。

后台地址：http://localhost:8080/cp/，用户名：admin，密码：password。后台前端基于 Vue 开发，如要修改后台界面，请另外下载 -cp 项目。

默认访问地址是 http://localhost:8080/ ，如需修改域名、端口等内容，可分别到后台配置 - 系统设置和配置 - 站点设置中修改。修改域名、端口等信息后，需要在内容 - 生成管理处，点击更新全部索引，以免全文检索及相关文章的 url 地址依然为原域名、端口地址。

前台模板

网站前台模板使用 Freemarker 作为模板引擎。通过修改模板文件，可以完全控制网站页面显示的内容。模板位置：

源码位置：src/main/webapp/templates
war 部署位置：templates
jar 部署位置：static/templates

war 部署

使用 maven 进行打包 mvn package -P war。会生成以下文件及文件夹：

target/-***.war 文件
target/-***/ 文件夹

如使用目录方式部署，可将 target/-***/ 目录下文件复制到 tomcat 的 webapps/ROOT 目录下（请先删除原 tomcat/webapps 目录下所有内容）。目录结构大致如下：

webapps/ROOT/cp
webapps/ROOT/templates
webapps/ROOT/uploads
webapps/ROOT/WEB-INF

如使用 war 包部署，可将 -***.war 更名为 ROOT.war（注意大小写），复制到 tomcat 的 webapps 目录下（请先删除原 tomcat/webapps 目录下所有文件夹）。复制完成后目录结构如下：

webapps/ROOT.war

war 部署要使用解压模式，tomcat 默认就是解压模式。如 tomcat 不会自动解压，请检查 tomcat/conf/server.xml 配置文件中 <Host ... unpackWARs="true"... > 配置项。

最后，检查 /WEB-INF/classes/application.yaml 文件中的数据库地址、用户名、密码相关配置是否正确。

jar 部署

使用 maven 进行打包 mvn package -P jar。

将打包的 target/-***.jar 文件复制到部署目录，并新建文件夹 static。

将 src/main/webapp 目录下所有文件复制到 static 目录下。

还可将 src/main/resources/application.yaml 配置文件复制到 config 目录。该配置文件将覆盖 -***.jar 内的原始配置（位于BOOT-INF\classes\application.yaml）。更新配置时，可避免修改 jar 包内的配置文件。

完整目录结构大致如下：

-***.jar
config/application.yaml
static/cp/...
static/templates/...
static/uploads/...
static/WEB-INF/...

在部署目录（即 -***.jar 所在目录）运行 java -jar -***.jar 命令，即可启动。

关于部署路径

程序通常在部署在 Tomcat 根目录，首页访问地址类似于：

http://www.mysite.com/
http://localhost/
http://localhost:8080/

然而，在某些特殊情况下（例如在 Eclipse 中默认启动 Tomcat 时），应用程序可能会被部署到某个子路径下，此时首页的访问地址类似于：

http://www.mysite.com//
http://localhost//
http://localhost:8080//

在这种情况下，网站前台可能会出现样式无法正常显示的问题。可以到后台配置 - 全局设置中设置上下文路径，例如 /。其中斜杠 / 不能省略，为部署路径。在开发环境中，部署路径通常为项目名称。

在开发环境中，建议尽量避免使用上下文路径，除非正式部署时也需要将应用程序部署到相同的路径下。否则，在开发环境中上传的图片在部署到正式环境时，可能无法正常显示。这是因为上传的图片地址会包含上下文路径信息（例如：//uploads/...）。

Eclipse 默认的 Tomcat 启动方式会将应用程序部署到一个特定的临时目录。因此，上传的图片（包括通过系统后台新增和修改的模板）会保存在这个临时部署目录中，而不是程序所在的目录。当修改了 Eclipse 中的源代码或文件时，系统会自动重新部署应用程序，导致之前上传的图片被清空。如果在开发环境中发现上传的图片突然丢失，很可能就是这个原因。

关闭表结构自动升级

程序在启动时会检查并升级数据库表结构版本，如果此时强行关闭程序，再次启动时会出现 LockException: Could not acquire change log lock 或 Waiting for changelog lock... 错误。如果您受此问题困扰，可在首次启动程序后（已成功创建表结构和初始数据），关闭表结构升级功能。

打开 application.yaml（源码位置：/src/main/resources/application.yaml，war 位置: WEB-INF/classes/application.yaml）文件，修改以下选项：

# 关闭 liquibase 的表结构升级功能
spring.liquibase.enabled: false
# 关闭 flowable 的表结构升级功能
flowable.database-schema-update: none
# 关闭执行初始化脚本
.data-sql-enabled: false

复制代码

程序升级时，需重新开启以上配置，否则数据库表结构无法自动升级。

MySQL 表名大小写

如果在 Windows 环境使用 MySQL，且以后需要迁移到 Linux 环境的 MySQL，建议将 Windows 环境的 MySQL 配置为表名大小写敏感模式。

因为 Linux 环境下 MySQL 的表名是大小写敏感的；而在 Windows 环境下 MySQL 表名大小写不敏感，且会自动把大写的表名改为小写的表名。从 Windows 向 Linux 迁移数据时，本为大写表名的成为了小写表名，导致程序出错。需要手动把小写表名改回大写表名，费时费力且容易出错。

系统的表名都为小写，不管在 Window 还是 Linux 下都没有问题，但第三方的类库（如 Liquibase、Flowable、Quartz 等）创建的表则为大写表名。所以 Windows 环境下也把 MySQL 设置成表名大小写敏感，有利以后迁移数据。

可修改 MySQL 配置文件 my.ini：