10分钟上手Java CMS！UJCMS零基础安装与实战指南（2025最新版）

你还在为搭建企业官网反复踩坑？服务器配置搞不定？数据库连接总是失败？本文将带你从0到1完成UJCMS（Java CMS）的本地化部署，全程可视化操作，代码小白也能轻松上手。读完本文你将获得：

• 3种部署模式的完整实施步骤（开发环境/生产环境/WAR包）
• 90%用户会遇到的8个核心错误解决方案
• 后台管理系统的核心功能快速上手指南
• 企业级部署的性能优化与安全加固方案

一、UJCMS系统架构与环境准备

1.1 技术栈解析

UJCMS采用分层架构设计，前后端分离与传统模板渲染双模式支持：

classDiagram
    class 后端技术栈 {
        +SpringBoot 2.7.x (应用框架)
        +MyBatis 3.x (ORM框架)
        +Spring Security (安全框架)
        +Lucene 8.x (全文检索)
        +FreeMarker (模板引擎)
    }
    class 前端技术栈 {
        +Vue3 (UI框架)
        +ElementPlus (组件库)
        +TypeScript (类型系统)
        +Vite (构建工具)
    }
    class 数据存储 {
        +MySQL 8.0 (主数据库)
        +Redis (缓存/集群支持)
        +本地文件系统 (媒体存储)
    }
    后端技术栈 --> 前端技术栈 : 提供API接口
    后端技术栈 --> 数据存储 : 数据持久化

1.2 环境要求清单

组件	最低版本	推荐版本	备注
JDK	11	17	OpenJDK/Zulu均可
MySQL	5.7.22	8.0.36	需启用utf8mb4编码
Maven	3.6.3	3.9.6	构建工具
Tomcat	9.0	10.1	WAR部署时需要
内存	2GB	4GB	生产环境建议8GB
磁盘	10GB	50GB	含日志和媒体文件

⚠️ 警告：Windows环境需特别配置MySQL表名大小写敏感（lower_case_table_names=2），避免后期迁移Linux时出现表名大小写问题。

二、3种部署模式分步实施

2.1 开发环境快速启动（适合学习/二次开发）

步骤1：获取源码

git clone https://gitcode.com/dromara/ujcms
cd ujcms

步骤2：配置数据库

创建UTF8MB4编码的数据库：

CREATE DATABASE ujcms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

修改src/main/resources/application.yaml配置：

spring.datasource.url: jdbc:mysql://localhost:3306/ujcms?serverTimezone=Asia/Shanghai&characterEncoding=UTF-8&nullCatalogMeansCurrent=true
spring.datasource.username: root
spring.datasource.password: password  # 替换为你的数据库密码

步骤3：启动应用

在IntelliJ IDEA中执行：

1. 右键src/main/java/com/ujcms/cms/Application.java
2. 选择Run 'Application'

首次启动会自动执行数据库初始化，控制台出现以下日志表示成功：

com.ujcms.cms.Application: Started Application in 28.452 seconds

2.2 生产环境JAR部署（推荐企业使用）

构建部署包

mvn clean package -P jar -Dmaven.test.skip=true

部署目录结构

/opt/ujcms/
├── ujcms-5.5.0.jar          # 应用程序包
├── config/                  # 配置文件目录
│   └── application.yaml     # 主配置文件
├── static/                  # 静态资源目录
│   ├── templates/           # 前端模板
│   ├── uploads/             # 上传文件
│   └── cp/                  # 管理后台前端
└── logs/                    # 日志目录

启动服务

nohup java -jar ujcms-5.5.0.jar --spring.profiles.active=prod > logs/startup.log 2>&1 &

2.3 WAR包部署（传统服务器环境）

构建WAR包

mvn clean package -P war -Dmaven.test.skip=true

Tomcat部署步骤

1. 将target/ujcms-5.5.0.war重命名为ROOT.war
2. 复制到Tomcat的webapps目录
3. 修改webapps/ROOT/WEB-INF/classes/application.yaml
4. 启动Tomcat：bin/startup.sh(Linux)或bin\startup.bat(Windows)

三、核心配置与验证

3.1 数据库连接详解

application.yaml核心配置说明：

# 数据库URL参数解析
spring.datasource.url: jdbc:mysql://localhost:3306/ujcms?
  serverTimezone=Asia/Shanghai&  # 时区配置（必须）
  characterEncoding=UTF-8&       # 编码设置（必须）
  nullCatalogMeansCurrent=true   # MySQL 8.0兼容性配置（必须）

# 连接池优化配置（生产环境）
spring.datasource.hikari:
  max-lifetime: 7200000          # 连接超时时间（2小时）
  maximum-pool-size: 10          # 最大连接数（CPU核心数*2+1）
  connection-test-query: SELECT 1 # 连接测试SQL

3.2 访问验证

访问地址	说明	默认账号	默认密码
http://localhost:8080	网站前台	-	-
http://localhost:8080/cp	管理后台	admin	password

首次登录后台后，建议立即执行：

1. 修改管理员密码（用户管理→管理员设置）
2. 配置网站基本信息（配置→站点设置）
3. 更新全文索引（内容→生成管理）

四、常见问题与解决方案

4.1 启动失败场景

错误现象	可能原因	解决方案
LockException: Could not acquire lock	数据库表结构升级中断	sql DELETE FROM databasechangeloglock; DELETE FROM flw_ev_databasechangeloglock;
Specified key was too long	MySQL索引长度限制	sql SET GLOBAL innodb_large_prefix=ON;
数据库连接超时	MySQL服务未启动	检查MySQL状态：systemctl status mysqld
字体相关IOException	缺少字体库	CentOS: yum install fontconfig

4.2 部署后访问问题

问题：后台样式丢失（CSS加载失败） 解决：检查上下文路径配置：

# 如部署在子路径需配置
server.servlet.context-path: /ujcms
# 同时在后台"配置→全局设置"中设置相同值

问题：上传图片无法访问 解决：开发环境需配置：

ujcms.uploads-location: /uploads
# 生产环境建议使用Nginx映射uploads目录

五、后台核心功能快速上手

5.1 内容管理工作流

flowchart TD
    A[创建栏目] --> B[配置模板]
    B --> C[发布文章]
    C --> D[设置SEO参数]
    D --> E[生成静态页]
    E --> F[预览与发布]

5.2 模板开发基础

UJCMS采用FreeMarker模板引擎，基本标签示例：

<!-- 文章列表标签 -->
[#list articleList as article]
<div class="article-item">
  <h3><a href="${article.url}">${article.title}</a></h3>
  <div class="meta">
    发布时间: ${article.publishDate?string("yyyy-MM-dd")}
    浏览量: ${article.views}
  </div>
  <div class="summary">${article.summary?substring(0,150)}...</div>
</div>
[/#list]

<!-- 分页标签 -->
[#paging pageInfo=articlePage]
  <div class="pagination">
    [@paging.previous]上一页[/@paging.previous]
    [@paging.pages]
      <a href="${url}" class="${current?'active':''}">${page}</a>
    [/@paging.pages]
    [@paging.next]下一页[/@paging.next]
  </div>
[/#paging]

六、企业级部署优化

6.1 性能调优配置

# 缓存配置
spring.cache.type: caffeine
spring.cache.caffeine.spec: maximumSize=500,expireAfterWrite=30m

# 线程池优化
spring.task.execution.pool:
  core-size: 8        # CPU核心数
  max-size: 16        # 最大线程数
  queue-capacity: 2048 # 任务队列容量

# 数据库连接池
spring.datasource.hikari.maximum-pool-size: 15

6.2 安全加固措施

1. 密钥配置（集群环境必须手动设置）：

jwt.secret: "your-64bit-random-secret-key-here"
jwt.token-secret: "16bit-token-key"

2. 关闭自动表结构更新（生产环境）：

spring.liquibase.enabled: false
flowable.database-schema-update: none
ujcms.data-sql-enabled: false

七、总结与进阶

通过本文你已掌握UJCMS的本地化部署与基础使用，建议继续深入：

• 模板开发：学习FreeMarker标签库与自定义标签开发
• API开发：基于RESTful接口构建前后端分离应用
• 插件开发：扩展系统功能满足特定业务需求
• 集群部署：实现高可用与负载均衡架构

UJCMS作为Apache-2.0协议开源项目，完全免费商用，官方提供完整的技术文档与社区支持。立即访问系统后台体验更多功能，开启企业级网站建设之旅！

[点赞+收藏]本文，关注作者获取《UJCMS模板开发实战》《企业级数据迁移指南》等进阶教程。有任何部署问题，欢迎在评论区留言讨论！