Tomcat 部署
校对日期:2026-11-16。适用于社区版及全部商业版。
War 安装包用于部署到已有的 Tomcat;部署到东方通应用服务器见东方通 TongWeb 部署。没有特别要求时,推荐用更简单的 Jar 部署 或 Docker 部署。
一、准备
- JDK 17 或 21,见 JDK 选择与安装。
- Tomcat 10.1 及以上。Tomcat 9 及更早的版本无法运行。建议使用一个干净的 Tomcat,不要同时部署其它应用。
- MySQL 8.0(5.7.22 及以上、8.0.20 及以上)和 一个空数据库,字符集选
utf8mb4。也支持 MariaDB 和 PostgreSQL; 达梦、瀚高等国产数据库需要商业版基础版及以上。驱动均已内置。不需要执行建表脚本,程序首次启动时自动建表并写入初始数据;数据库账号须有建表、改表结构和读写数据的权限。 - 安装包。在官网下载页 https://www.ujcms.com/downloads/ 下载 war 安装包。
二、部署与启动
清理
tomcat/webapps/下原有的全部文件夹(包括ROOT)。拷贝程序。把安装包中的
ROOT文件夹拷贝到tomcat/webapps/下。目录名必须是大写的ROOT, 这样程序才部署在根路径下;路径中不要有中文或空格。拷贝后的结构:目录 内容 webapps/ROOT/ cp/ 后台管理界面 webapps/ROOT/ themes/ 前台模板 webapps/ROOT/ uploads/ 上传的文件 webapps/ROOT/ WEB-INF/ 配置文件 classes/、程序 jar 包application. yaml lib/,以及运行时生成的全文索引(lucene/)、备份文件(backup/)等填写数据库连接。打开
webapps/,修改三项:ROOT/ WEB-INF/ classes/ application. yaml yamlspring.datasource.url: jdbc:mariadb://127.0.0.1:3306/ujcms?allowPublicKeyRetrieval=true&allowLocalInfile=false&nullDatabaseMeansCurrent=true spring.datasource.username: 数据库用户名 spring.datasource.password: 数据库密码MySQL 与 MariaDB 都使用
jdbc:mariadb://开头的地址,把其中的127.0.0.1、3306、ujcms换成数据库的地址、端口和库名。 PostgreSQL 及国产数据库的写法见该文件中的注释。启动 Tomcat。Windows 双击
tomcat/;Linux 执行bin/ startup. bat tomcat/,日志在bin/ startup.sh tomcat/, 停止执行logs/ catalina. out tomcat/。bin/ shutdown.sh 等待启动完成。首次启动要建表并写入初始数据,需要一些时间。日志中出现
Started Application in xxx seconds即启动完成。完成安装。浏览器打开
http:,进入安装向导,设置站点和管理员账号。向导第一步需要的安装令牌 在启动日志里,也写在/ / 服务器地址: 8080/ cp/ webapps/中。系统没有默认的管理员密码。各步骤的说明见安装向导与无人值守安装。ROOT/ WEB-INF/ install-token. txt
三、Tomcat 的设置
端口、内存等按 Tomcat 自己的方式配置:端口在 tomcat/,JVM 参数写在 tomcat/(Windows 为 setenv.bat)。
数据库驱动和模板都按 JVM 时区读写、显示时间。服务器系统时区不正确时,在 JVM 参数中加 -Duser.。
四、部署路径
程序应部署在根路径(http:)。如果部署在子路径下(http:),前台页面会没有样式, 需要到后台 配置 → 全局设置 中把 上下文路径 设为该路径(如 /ujcms,开头的斜杠不能省略)。
上传文件的地址里带有上下文路径,所以开发、测试和正式环境应使用相同的部署路径,否则迁移后图片无法显示。
五、常见问题
- 用 war 文件而不是文件夹部署。 从源码打包得到的
ujcms-x.x.x.war改名为ROOT.war(注意大小写)后放到webapps/下。 必须使用解压模式,Tomcat 默认即是;没有自动解压时检查tomcat/里conf/ server. xml <Host>的unpackWARs=。"true" - 前台页面没有样式。 程序没有部署在根路径,见上文“部署路径”。
- 启动时报
Could not acquire change log lock或一直显示Waiting for changelog lock...。 上一次启动在建表或升级表结构时被强行中断。 清空数据库中databasechangeloglock和flw_两张表的数据(注意不是ev_ databasechangeloglock databasechangelog)后重新启动。 - 启动时报
Specified key was too long; max key length is 767 bytes。 把 MySQL 参数innodb_设为large_ prefix ON。 MySQL 5.7.7 起该参数默认已开启,但部分面板或云数据库修改了默认配置。 - 启动时报
Connection to … refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.程序连不上数据库。先核对spring.里的地址和端口;地址无误时,通常是数据库没有允许从程序所在的服务器连接。 PostgreSQL 以及瀚高等同类数据库要在数据库一侧放开监听地址(datasource. url postgresql.conf的listen_)和客户端地址(addresses pg_hba.conf), 改后重启数据库,具体做法以数据库厂商的文档为准。 - 需要安装包里没有的数据库驱动。 把驱动 jar 放到 Tomcat 的
lib/目录。